Promotions¶
Promotions automatically issue a gift card to a customer when their order meets conditions you set. For example: "spend $100 or more and get a $10 gift card".
Not the same as the Promotions widget
This article covers gift card promotions: rules that issue a gift card after an order. If you want to reward customers with store credit through workflows and tiers, see Loyalty. To show a reward banner or nudge on your storefront, see the Promotions widget.
Where to find it¶
Open the Promotions card on the Gift Card Hero home page and click Manage promotions.
The card appears only when Promotions is enabled for your store. If you don't see it, contact support.

The promotions list¶
The list shows every promotion with these columns:
- Name — the promotion's internal name (click to edit)
- Description — a short description; hover to read the full text
- Gift Card Value — the value of the card issued each time the rules are met
- Schedule — the date range, for example
Nov 15 – Dec 24,From Nov 15,Until Dec 24, or—if the promotion has no dates - Status — Active, Scheduled (start date in the future) or Expired (end date passed)
- Actions — an Edit link
To delete promotions, tick their checkboxes and click Delete promotions. Deletion is permanent and stops the promotion immediately. Cards already issued are not affected.
Pausing a promotion
There is no pause switch. To stop a promotion, set its end date to today, or delete it.
Creating a promotion¶
Click Add Promotion. The page is called Add Gift Card Promotion.

- Enter a Promotion Name. Customers don't see it.
- Optionally add a Description.
- Enter the Gift Card Value. It must be greater than 0.
- Optionally set a schedule (see below).
- Add at least one rule (see below).
- Click Save in the bar at the top.
After you save, you return to the list.
Schedule¶
Tick Set start date and/or Set end date and pick the dates. The promotion runs from the start of the start date through the end of the end date, in your local time zone. Leave a date unticked for an open-ended promotion. The end date must be after the start date.
Rules¶
A rule is one or more conditions. A promotion needs at least one rule.
- Under Add New Rule, enter a Rule Title (optional).
- Choose a Rule Operator: AND (all conditions must match) or OR (any condition can match).
- Choose a Condition Type, an Operator and a value.
- Click Add Condition. Repeat for more conditions.
- Click Create Rule.
The rule appears under Existing Rules. Use the trash icon to remove it. Rules take effect when you click Save.

| Condition type | Operators | What it checks |
|---|---|---|
| Cart Subtotal | GREATER THAN, LESS THAN, EACH | The order subtotal: item prices after discounts, before shipping and tax |
| Products | CONTAINS, NOT CONTAINS | Whether selected products are in the order. Click the field to pick products. |
| Selected Products Subtotal | GREATER THAN, LESS THAN, EACH | The subtotal of the selected products only, after their discounts. Pick the products and an amount. |
How much is issued¶
The Gift Card Value is multiplied or paid once, depending on the rule:
- No EACH or Products condition — the card's value is issued once when the rule matches. Example: Cart Subtotal GREATER THAN 100, value $10 gives one $10 card to every order above $100.
- EACH — the card's value is issued once for every full multiple of the amount. Example: Cart Subtotal EACH 100, value $10 gives $10 for a $150 order and $30 for a $350 order. Orders below $100 get nothing.
- Products CONTAINS — the card's value is issued once for every unit of the selected products in the order. Example: two units of a selected product and a value of $5 gives a $10 card.
If several rules match the same order, their amounts add up into one card for that promotion. If several promotions match, each issues its own card.
NOT CONTAINS
A rule that has a Products condition issues the value per unit of the selected products. With NOT CONTAINS there are none, so the rule issues $0 unless it also has an EACH condition. Use NOT CONTAINS together with an EACH condition, or use CONTAINS.
Editing a promotion¶
Click the promotion's name or Edit. The page is called Edit Gift Card Promotion and has the same fields. Click Save to keep your changes.
Changes apply to new orders only. Cards already issued are not affected.
Issued Gift Cards¶
Below the list, the Issued Gift Cards table shows every card that promotions have issued: the order, the promotion, the amount, the last characters of the Shopify gift card ID, and the issue date.

Narrow the table with:
- the date range (default: All time)
- the Promotion dropdown
- the search box — enter an order number or gift card ID and click Search
Click Reset to clear the filters. Click Export CSV to download the rows that match your filters. The file includes the order, promotion, amount, the card's remaining balance and the last characters of its code. An export can hold up to 50,000 rows; if you have more, narrow the date range or pick one promotion.
How it works¶
- A customer's order is paid.
- Gift Card Hero checks the order against every promotion that is currently running (started and not yet ended).
- For each promotion whose rules match, Gift Card Hero creates a Shopify gift card for that customer. It expires one year after it is issued, and its note says "Auto-issued (Promotions)" with the order number.
- The card is added to Issued Gift Cards.
Shopify emails the card to the customer as soon as it's created, with its Gift card created notification. The card is attached to the customer, so you can also find it under Gift cards in Shopify admin and send the email again with Resend gift card.
Troubleshooting¶
The "Access scope update required" banner appears. The app needs an extra Shopify permission. Click Update permissions and approve it. You can't add a promotion until you do.
An order matched, but no card was issued. Check that the promotion was running when the order was paid (see Schedule and Status), and that the order has a customer. Check the rule too: a Products rule with NOT CONTAINS issues $0 on its own (see above).
A product called "Gift Hero Reward" appeared in my Shopify products. Gift Card Hero creates it the first time you save a promotion. Don't delete it.