> For the complete documentation index, see [llms.txt](https://docs.giftcardfactory.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.giftcardfactory.app/campaigns/gift-card-rewards.md).
# Gift Card Rewards
Reward customers with free gift cards
{% hint style="info" %}
Explore our Flow Template library to find a flow similar to the Gift Card Rewards flow. It is ideal for creating more complex campaigns.
{% endhint %}
### Overview
Gift Card Rewards is an automated campaign that issues gift cards to customers when they complete a qualifying purchase. A gift card code is dispatched right after the order is paid, creating an immediate incentive to encourage repeat business.
**Common use cases:**
* Reward loyal customers with gift cards on every purchase
* Encourage larger orders through tiered spending thresholds
* Run time-limited promotions (e.g., "Get a $10 gift card on orders over $50 this weekend")
* Target specific customer segments or product collections
### π‘Common Use Cases
**Cashback on Every Order** β Give 5% back as a gift card on every purchase, with no minimum. Perfect for: Stores wanting a simple loyalty mechanic that brings customers back.
**Tiered Spending Incentive** β Set tiers at $50/$5, $100/$15, $200/$30 to reward larger baskets. Perfect for: Encouraging customers to add more items to hit the next reward level.
**Weekend Flash Promotion** β Use active dates to run a Friday-to-Sunday campaign offering a $10 gift card on orders over $75. Perfect for: Short-term sales events without creating discount codes.
**Collection-Specific Reward** β Apply the campaign only to a "New Arrivals" collection with a 10% reward. Perfect for: Driving traffic to specific product lines or clearing seasonal inventory.
**VIP Customer Appreciation** β Restrict eligibility to a "VIP" customer segment and offer higher reward tiers. Perfect for: Rewarding your best customers differently from the general audience.
**First Purchase Welcome Gift** β Set max gift cards per customer to 1 and offer a $10 reward on any order. Perfect for: Turning first-time buyers into repeat customers with a guaranteed second visit.
### Creating a Campaign
Navigate to **Campaigns** in the app and click **New Campaign** > **Gift Card Rewards**.
#### Title
Give your campaign a descriptive name (e.g., "Holiday 10% Cashback" or "VIP $20 Reward"). This title is visible only to you and your staff.
***
#### Gift Card Value
This section controls how the gift card value is calculated and which products qualify.
**Currency (multi-currency stores)**
Shown only when your store has market currencies enabled besides the store currency. By default every order is evaluated in your store currency, and gift cards are issued in it.
* **Order currency** β **Any currency** (default) evaluates every order converted to the store currency. Pick a specific currency to make the campaign respond **only to orders placed in that currency**; tier minimums and the minimum purchase amount are then compared against the order totals in that currency. Orders placed in other currencies are ignored, so create one campaign per currency if you want to reward each market (e.g. one campaign for AUD and one for NZD).
* **Gift card currency** β the currency the reward gift card is issued in. It follows the order currency by default, but you can pick the store currency or any market currency.
* **Redemption in** β shown when a market currency (other than the store currency) is selected:
* **All currencies** β the balance is converted with spot exchange rates when the card is redeemed in another currency.
* **Issued currency only** (default) β the card can only be redeemed for purchases in the currency it was issued in.
Gift cards issued in the **store currency** are always redeemable in any currency β exchange rates are determined at checkout using your Market settings.
App Email templates format the gift card amount in the card's currency automatically, so an NZD card shows as `NZ$50.00` even if your store currency is AUD.
**Value Type**
Choose between two modes using the tabs:
**Fixed Amount** β Define tiers with minimum order values and corresponding gift card amounts. When an order qualifies, the highest matching tier is used.
**Percentage of Order** β The gift card value is calculated as a percentage of the qualifying line items total.
**Tiers (Fixed Amount only)**
Each tier has:
* **Minimum value** β The minimum line items total required to qualify (in the order currency)
* **Gift card value** β The gift card amount issued when this tier is reached (in the gift card currency)
Tiers are evaluated from highest to lowest. The first tier where the order total meets the minimum is used. You must have at least one tier.
**Example:**
| Minimum Value | Gift Card Value |
| ------------- | --------------- |
| $100 | $15 |
| $50 | $5 |
An order of $120 would receive a $15 gift card. An order of $75 would receive a $5 gift card. An order of $30 would not qualify.
**Applies To**
Control which products count toward the qualifying total:
* **All products** β Every product in the order counts
* **Specific collections** β Only products from selected collections count
* **Specific products** β Only selected products and their variants count
When using specific products or collections, only the matching line items are used to calculate the order total and gift card value.
***
#### Minimum Purchase Requirements
Set additional conditions the order must meet before a gift card is issued:
* **No minimum requirements** β Any qualifying order receives a gift card
* **Minimum purchase amount** β The qualifying line items total must reach a specified amount
* **Minimum quantity of items** β The order must contain at least a specified number of qualifying items
***
#### Eligibility
Control which customers can receive gift cards from this campaign:
* **All customers** β Any customer who places a qualifying order
* **Specific customer segments** β Only customers belonging to a selected Shopify customer segment
* **Specific customers** β Only individually selected customers
***
#### Active Dates
Set a time window during which the campaign is active. Orders placed outside this window will not trigger gift cards, even if the campaign status is Active.
* **Start date** β When the campaign begins accepting qualifying orders
* **End date** β When the campaign stops (optional β leave blank for no end date)
Each date includes a time and timezone picker for precise control.
***
#### Gift Cards
Configure the gift card properties:
* **Auto-expiration** β Set when the issued gift card expires (never, or after a specified period from creation)
* **Max gift cards per customer** β Limit how many gift cards a single customer can receive from this campaign (e.g., set to 1 for one-time promotions)
* **Gift card message** β A customer-visible message attached to the gift card (max 200 characters)
* **Gift card note** β An internal note not visible to the customer
***
#### Delivery
Choose how the gift card is delivered to the customer:
* **Shopify Email** β Uses Shopify's built-in gift card notification. Free, no additional setup required.
* **App Email** β Sends a custom-designed email using your configured email template. Allows full control over design and branding. Uses App Email credits (1 per email)
* **Klaviyo** β Triggers a Klaviyo event with gift card data. You design the email in Klaviyo.
* **Shopify Flow** β Triggers a Flow event. Use Shopify Flow to build custom delivery logic.
When using App Email, select an email template from your configured templates.
Read more about different gift card delivery options in [Sending Customer Notifications](/misc/sending-customer-notifications.md) section
***
#### Test Mode
Enable test mode to validate your campaign before going live. When test mode is on, only orders placed with the specified test email address will be processed. All other orders are ignored.
***
### Activating the Campaign
After creating the campaign, it starts in **Inactive** status. To activate:
1. Go to **Campaigns** and find your campaign
2. Click into the campaign detail
3. Toggle the status to **Active**
When activated, the app registers a Shopify webhook to listen for paid orders. The webhook includes a price filter so only potentially qualifying orders trigger processing. When an order currency is selected, the filter also limits deliveries to orders placed in that currency.
***
### How It Works
When a customer places an order:
1. **Order currency check** β If the campaign is limited to one currency, was the order placed in it? Other orders are skipped.
2. **Active dates check** β Is the current time within the campaign's active window?
3. **Customer eligibility** β Does the customer match the eligibility criteria?
4. **Line item filtering** β Which products in the order match the "Applies to" setting?
5. **Minimum requirements** β Do the qualifying items meet the minimum purchase amount or quantity?
6. **Value calculation** β What gift card value does the order qualify for (tier match or percentage)?
7. **Per-customer limit** β Has the customer already reached the maximum gift cards for this campaign?
8. **Gift card issuance** β A gift card is created and delivered via the configured method
Each step is logged in the campaign run history for troubleshooting.
#### Cancellations and Refunds
Rewards are reversed automatically when the order that earned them changes:
* **Order cancelled or fully refunded** β the reward gift card is deactivated and the customer's per-campaign limit is restored, so they can earn again on a new order.
* **Order partially refunded** β the reward is recalculated on the remaining items. If they still qualify for a lower value, the difference is debited from the card. If they no longer qualify, the card is deactivated.
If part of the reward was already spent, only the remaining balance is debited. The outcome is shown as a **Deactivated** or **Reduced** badge next to the gift card in the campaign runs list.
This applies to campaigns activated after this feature was released. To enable it on an older campaign, open it and save it again while it is active.
***
### Storefront Display (Optional)
You can show customers the potential gift card they'll earn before they complete their purchase. Two extension options are available:
#### Theme Extension (Cart Page)
Add the **Gift Card Reward Banner** block to your theme. It automatically:
* Calculates the potential gift card based on current cart contents
* Updates in real time as items are added or removed
* Hides when no gift card is available
* Only shows campaigns whose order currency matches the currency the customer is shopping in
* Supports customizable colors (background, text, accent)
#### Checkout Extension
The **Gift Card Reward** checkout extension displays a banner at checkout showing the potential gift card amount. It uses the same calculation logic as the theme extension.
***
### Campaign Runs
Every time the campaign processes an order, a **Campaign Run** is created. View runs from the campaign detail page to see:
* **Status** β Finished, Error, Skipped, or Limits Error
* **Sent** β Number of gift cards issued
* **Skipped** β Number of orders that didn't qualify
* **Gift card details** β ID and last 4 characters of issued gift cards, with a **Deactivated** or **Reduced** badge when the order was cancelled or refunded
***
### Tips
* **Start with test mode** β Always validate with a test order before activating
* **Use tiers for upselling** β Show customers the next threshold to encourage larger orders (e.g., "Spend $50 more to get a $15 gift card instead of $5")
* **Combine with active dates** β Run weekend-only or holiday promotions without manually toggling the campaign
* **Percentage mode for simplicity** β Use a flat percentage (e.g., 5%) when you don't need tiered thresholds
* **Check campaign runs** β If a customer reports not receiving a gift card, check the run logs to see which step filtered them out
