eGift Cards & Physical Gift Cards¶
The Gift cards page (eGift/Physical cards in the app's left navigation) is the main configuration area for both digital (eGift) and physical gift cards. Click eGift/Physical cards in the left navigation.
The page has two tabs: E-Gift cards and Physical gift cards. Changes are saved with the Save button in the bar that appears at the top of the page. Discard reverts them.

E-Gift cards tab¶
Enable or disable eGift cards¶
The Enable eGift cards section shows whether the builder is on. Click Disable or Enable and save. When eGift cards are disabled, the gift card form is hidden on your gift card products.
Use View gift card products and Add gift card product to jump to the matching pages in Shopify admin.
Free design help
The yellow banner Request free gift card product page design changes opens a chat with support. We adjust colors and add your logo to the gift card form at no charge.
Card designs¶

The Card designs section has two groups:
- Prebuilt designs — the designs that come with the app. Tick or untick the checkbox on a thumbnail to offer it or hide it.
- Custom designs — your own images.
Drag a thumbnail to change the order customers see. Click a thumbnail to preview it.
To add your own design, drop an image into the upload box at the end of Custom designs. Accepted formats are PNG and JPG, up to 5 MB. The recommended size is 950 × 550 px (aspect ratio 5:3); the minimum is 450 × 270 px. Click the trash icon on a custom design to delete it.
Below the thumbnails you can set:
| Option | What it does |
|---|---|
| Allow customers to upload their own gift card images | Buyers can use a picture of their own as the card design |
| Number of designs displayed at once | How many designs show in the gallery before the View more button. Default is 3 |
| Use gift card product images as gift cards | Uses the images uploaded to the gift card product in Shopify as designs. For the best result use a 5:3 image |
| Lock design for variant | Appears with the option above. Ties each design to its variant, so the design changes when the buyer picks another denomination |
To sort designs into occasions, click Categories. See Card Categories & Organization.
Cards created in bulk can carry their own artwork too. See Managing Gift Cards with Bulk Actions.
Purchase options¶

Allow custom amount lets customers type any amount instead of picking a fixed denomination. When you tick it:
- Custom amount item SKU (not mandatory) — an optional SKU for custom-amount cards.
- Set minimum and maximum amount allowed — shows Minimum allowed and Maximum allowed fields in your store currency. If your store sells in several currencies through Shopify Markets, Set min/max for other currencies lets you override the limits per currency. A currency left empty uses the default limits.
- Gift card expiration — choose Gift cards never expire, or Gift cards expire with a number of years, months or days. This applies to cards issued with a custom amount.
The app needs extra access to Shopify for this feature. If you see a banner asking for additional access scope, click Give the app additional scope and approve it. After you tick the box, Shopify takes 5–10 minutes to fully activate custom amounts; a progress bar shows the setup.
The system product
To make custom amounts work at checkout, Gift Card Hero creates a system product in your catalog, tagged gift-hero-system, with a placeholder price of 0.01. The app rewrites the line price at checkout to the exact amount the customer chose.
- Don't delete or edit it while custom amount is on — removing it breaks the feature.
- It is created with the status Unlisted, so it does not show in collections or search.
- If you turn custom amount off, ask support to clean it up.
Allow scheduled send lets the buyer pick a delivery date. If the app lacks the required access, a banner offers Give the app additional scope.
Force gift cards to be onetime marks a card as used after its first redemption, so any remaining balance cannot be spent again. Choose the gift card products it applies to in the picker that appears.
Gift card page¶
Despite its name, this section covers two pages: the gift card form on your product page (recipient name, hiding the amount, the default tab, video messages, Buy now) and the gift card page the recipient opens from the email (animation, Start shopping link, QR code).
| Setting | What it does |
|---|---|
| Show recipient's name field | Adds a recipient name field to the gift card form |
| Let the buyer hide the amount from the recipient | Adds the question "Would you like the gift card amount to be visible to the recipient?" with Yes and No to the eGift card form. See Hiding the amount from the recipient |
| Set "Send to me" tab as a default | The form opens on Send to me (delivery to the buyer's checkout email) instead of Send as a gift |
| Allow video messages | Buyers can record a video message of up to 1:30 on the form, or upload one of up to 200 MB. On an iPhone, the phone's own menu offers to film or to pick a video. Videos stay available for 60 days after the card is issued |
| Disable gift card page animation | Turns off the opening-envelope animation |
| Show "Buy now" button | Adds a button under Add to cart that goes straight to checkout |
| Use custom link for the Start shopping button | Replaces the link of the Start shopping button with the Custom URL you enter (up to 200 characters) |
| Hide the QR code on the gift card page | Removes the QR code from the page |
| Replace POS QR code at a gift card page with the shop link | The QR code opens your store instead of the POS app. Not available while the QR code is hidden |
When a card holds more than it was issued with — for example after a reload, or a card issued above Shopify's single-card cap and credited the rest — the gift card page and email show the current balance as the card's value. A card that was only spent down keeps showing the amount it was issued with, with the remaining balance on its own line.
Hiding the amount from the recipient¶
With Let the buyer hide the amount from the recipient on, the eGift card form asks the buyer whether the recipient may see the amount. Yes is selected by default. The question is shown in your store's language and can be edited in Settings → Translations → eGift card widget.
- The answer belongs to each card, so two cards in one order can have different answers.
- When the buyer answers No, that card's page shows the design without the amount and without the remaining balance line. The PDF and the printout of the page follow it, and so does the preview on the product page.
- The recipient's email leaves out the amount only if you use the Gift Card Hero email template. Shopify's standard "Gift card created" email always shows it. A template generated before this setting existed shows the amount: generate it again and paste it into Shopify.
- The card keeps its full value and works as usual. Where it is spent or checked, the balance still shows: at checkout, in the balance checker, in the customer account, in Apple Wallet and in unused balance reminders.
- Physical gift cards don't get the question.
Customer account (legacy)¶
These two options apply to the old, classic customer account pages only:
- Hide my gift cards in user's account — hides the My Gift Cards section.
- Show balance check widget on My gift cards page — adds the balance widget to that section.
With the new customer accounts, use the extension described in Customer Account Portal.
Notifications (and Markets)¶
Send copy of gift card email to specified address sends a copy of every gift card email to the Email address for copies you enter. Use it for quality control or record keeping.
If your store sells in more than one currency through Shopify Markets, this section also shows:
| Setting | What it does |
|---|---|
| Enable Shopify Markets support | Converts gift card amounts to the customer's local currency on the storefront, following your Markets settings |
| Cross-currency redemption | What happens when a card is used in a currency other than the one it was issued in |
Cross-currency redemption applies to every card this app issues, including bulk import, generate and mass send:
| Option | Behaviour |
|---|---|
| Shopify default | Shopify decides, based on your store and market settings |
| Only in the card's own currency | The card is refused at checkout in any other currency |
| Convert at your market's exchange rate | Uses the rate configured for that market |
| Convert at the spot exchange rate | Uses the standard spot rate at the time of checkout |
To issue cards in a specific currency in bulk, see Issuing cards in other currencies.
Physical Gift Cards tab¶
Controls physical gift cards: enabling them, purchase options, the additional charge, code upload and assignment. See Physical Gift Cards for the full workflow.
Header buttons¶
| Button | Where it goes |
|---|---|
| Issue e-Gift card | Opens the manual issuing form (E-Gift cards tab only) |
| Order physical gift cards | Opens Shopify's hardware store page for printed cards (Physical gift cards tab only) |
| Translations | Opens Settings → Translations, on the eGift card widget texts. See Design & Translations |
Issuing a gift card manually¶
Use this to hand a single card to someone — for example as a goodwill gesture or compensation.
- Click Issue e-Gift card in the page header.
- Fill in the form:

| Field | Notes |
|---|---|
| Initial value | Amount the card is issued with. Must be greater than 0 |
| Currency | Shown next to the value only when your Shopify Markets enable more than one currency. Pick the currency the card is issued in — it cannot be changed afterwards |
| Message | Optional personal message, up to 200 characters |
| From | Sender name shown in the email, up to 40 characters |
| Gift code | Leave blank to generate a code, or type your own: 8 to 18 letters and numbers, no spaces or symbols |
| eGift card design | Pick one of the design thumbnails |
| Customer email (in the Find customer box) | Optional. The address the gift card email goes to. If no customer has this email, one is created |
| Notes | Internal note, never shown to the recipient |
- Click Send gift card in the bar at the top.
With a customer email, the card is created and the gift card email goes to that address right away. Without one, the card is simply created, nothing is emailed and the card is not filed under any customer.
Either way a Gift card issued banner shows the full code with a Copy button.

Copy the code before you leave
This banner is the only place in the app that shows the code. The app stores codes encrypted, and Shopify's admin keeps only the last four characters; staff can see the full code later in the Gift Card Management block on the card's page in Shopify admin (see Gift Card Admin Block).
Cards over $2,000
Shopify issues at most $2,000 on a single card, or the equivalent in your store currency. To issue more, first turn on Increase limit in Reload Balance settings. The app then raises the cap to $10,000 or the equivalent. Without it, Shopify refuses the larger amount and no card is created.
Regular products as gift cards¶
Open eGift/Physical cards, then in the enabled banner next to Sell gift cards through regular products click Configure. The page is titled Regular products as gift cards.

Click Browse and select any Shopify products that should behave as gift cards. When one of them is sold, Gift Card Hero creates a gift card with a value equal to the variant price and emails it, instead of treating the order as a normal item.
The gift card form on the product page is optional. While eGift cards are enabled, an order placed without it (quick add, Buy it now, a draft order, POS) still gets a gift card, emailed to the buyer, unless Don't send gift card email to purchaser is on. An order with no customer gets no email; with Save gift codes in order notes on, its code is in the order notes.
Each selected product shows a badge:
- All variants selected — every variant triggers a gift card.
- X of Y variants selected — only the chosen variants do.
Options for the selected products:
| Option | Description |
|---|---|
| Skip gift codes generation | The app generates no codes. Use it if you manage codes outside the app. Turns off code generation and uploads on this page |
| Save gift codes in order notes | Adds the code to the Shopify order notes |
| Save masked gift code as order tag | Adds a tag such as gift-card-#1:************6OMN to the order, useful for filters and automation |
| Mask gift code in order notes | Stores only the masked code. Applies to both notes and tags |
| Include Shopify line item ID in tags & notes | Adds the line item ID so each code can be matched to its order line |
| Don't send gift card email to purchaser | Does not send the gift card email to the buyer |
| Don't mark item as fulfilled | Leaves the line item unfulfilled after the card is issued |
| Track inventory for variants | Keeps each variant's inventory equal to the number of unused codes. Needs the inventory permission; click Update permissions if asked |
Predefined gift codes¶
Upload a list of ready-made codes. Gift Card Hero assigns the next available code to each order, instead of generating one. This suits codes you pre-printed.
- In Predefined Gift Codes for Regular Products, click Upload codes.
- Choose the product, and optionally a variant. Leave the variant empty for all variants. Save your product selection first.
- Paste the codes, one per line.
- Click Submit codes.
The table lists each code with its status (Available, Used or Error), the product, the registration date and the order it went to. Counters above the table total each status. A code that is still Available can be removed with the trash button.
Refunds¶
- A refund that does not list the gift card's own order line (a goodwill refund, a shipping refund, a discount after the sale) leaves the card untouched.
- When the refunded line is a card the app issued for a custom amount, Gift Card Hero takes the whole remaining balance off the card, with a note on the card saying how much to credit back if you need to undo it. It does not deactivate the card. If the card was scheduled for later delivery and has not been created yet, it is cancelled and never sent.
- A card that is already at zero, or already deactivated, is skipped.
- Cards sold through Shopify's own gift card products are handled by Shopify when you refund the line.
The app registers the refund handling automatically while Allow custom amount is on.
How it looks on your storefront¶
