Reload Balance (Top-up)¶
The Gift cards balance reload page lets you find a gift card and change its balance — add money, remove money, or set the balance to an exact figure. Go to Reload Balance in the left navigation.
From the same page you can set the reload limit and the confirmation email, and let customers reload their own cards from your storefront.
Finding a gift card¶
The page shows a searchable, paginated list of your gift cards. Type in the Filter gift cards box to search by the last characters of the card's code or by the customer's email address.
Searching by code
For the most reliable match, enter the full gift card code. A few trailing characters can match more than one card.
The list shows each card's code (as Code ending ...), Status (Enabled or Disabled), Date issued, and Remaining / Initial value. Cards in a currency other than your store currency show their own currency code. Use the arrows below the list to page through results.
If the app needs an additional Shopify permission for this page, a banner appears with a Give the app additional scope button.

Adjusting a balance¶
- Click Code ending ... on the card you want to change. (Disabled cards cannot be adjusted, so their code is not a link.)
- Under Method, choose how to enter the change:
- Set final balance — type the balance the card should have. The change is worked out for you.
- Set amount — choose Add or Remove and type the amount.
- Optionally add a Note. It is saved with the adjustment and shown in the transactions history.
- To tell the customer, tick Send email to the recipient (see below).
- Click Save in the bar at the top of the page.
The page shows the card's current balance next to the new one, in the card's own currency. Below the form, Gift card transactions history lists every adjustment with its date, amount and note.
The change must not be zero: the new balance cannot equal the current one, and an amount cannot be 0.

Disabled and expired cards
A disabled card cannot have its balance changed. For an expired card, update the expiry date first, then adjust the balance.
This is useful for:
- Store credit — add credit as a goodwill gesture or compensation
- Loyalty rewards — top up a card when a customer reaches a spending threshold
- Corrections — fix a balance that was set incorrectly
At POS, staff can also reload cards directly through the Gift Card Hero POS tile. See POS Integration for details.
Emailing the customer¶
Send email to the recipient is available when the card has a customer attached in Shopify. If it does not, the checkbox is disabled with a note, because there is nobody to email.
When you tick it, the subject and body from your reload confirmation email appear filled in with this card's figures, and you can edit them for this one message. Configure template next to the subject opens the template editor.
Configuration¶
Click Configuration in the page header to open the reload settings. The same settings are in Settings → Reload balance.

Reload limit¶
A badge shows whether the $10 000 limit is Enabled or Disabled.
- Click Increase limit to raise Shopify's $2,000 per-card cap to $10,000 or the equivalent, for reloads and for cards you issue (requires the
write_draft_ordersShopify scope) - Click Decrease limit to return to Shopify's default limit of $2,000
The first time you increase the limit, the app asks you to confirm. It creates a draft order in the background and removes it again, and you may get a Shopify notification about an empty order being completed. This is expected.
If the write_draft_orders scope is missing, a warning banner appears with a Give the app additional scope button.
Reload confirmation email¶
The email sent to the cardholder after a balance is reloaded. The Reload confirmation email row shows its subject and whether it is set up; click Edit template to open the editor, which has a preview and a test send.

| Field | Notes |
|---|---|
| Subject | Required. Subject line of the notification |
| Body | Required. Body text of the notification |
- Preview renders the email with sample figures, in the same wrapper the real email uses.
- Send test email opens a small form with the address to send to, prefilled with your store's contact email. The test goes out through your delivery method — your own mail server when that is the store default in Integrations, ours otherwise — with the subject marked
[Test]. - The editor opens with sample text until you write your own; Reset puts the sample text back.
Available placeholders:
| Placeholder | Outputs |
|---|---|
{first_name} |
Customer's first name |
{last_name} |
Customer's last name |
{email} |
Customer's email address |
{initial_value} |
Original face value of the gift card |
{balance} |
Balance before the reload |
{new_balance} |
Balance after the reload |
{last_characters} |
Last digits of the gift card code |
{reload_amount} |
Amount added in this transaction |
Both fields are required — if either is left empty, the editor refuses to save. Unlike the other notifications, this email has no built-in version: what you save is what is sent. The email is sent only when Send email to the recipient is ticked for the adjustment.
Storefront reload¶
Let customers add money to a gift card they already own by buying a reload product on your store. Click Storefront reload in the page header of the reload page.

Setting it up¶
- Click Enable next to Storefront reload is Disabled. The app creates a reload product in your store. Use Configure product to edit its SKU, description and images in Shopify.
- Under Fixed reload options, type an amount and click Add option for each amount customers can pick. Each amount becomes a variant of the product. Remove one with the x on its tag.
- To let customers type their own amount, tick Allow custom reload amount and optionally set a Minimum amount and Maximum amount. Leave a field empty for no limit.
- Under Visibility, keep Available in search and collections ticked to show the product in your store. Untick it and the product is set to Draft and is no longer visible.
- Click Save in the bar at the top.
You need at least one fixed option or a custom amount. The first time you save with a custom amount, a banner explains that Shopify can take up to 10 minutes to register the function that prices it, and custom amounts may not work until then.
Texts on the reload form are translated in Settings → Translations (choose Storefront reload under Feature area); the Translations button on this page takes you there.
What customers see¶
On the reload product page, the customer:
- Picks an amount, or Custom and types one. The allowed range is shown under the field.
- Types their Gift card code (or taps Scan QR to scan the card) and clicks Check card. The form shows the last four characters, the current balance and the expiry date. Disabled cards are refused.
- Clicks Add to cart and goes to the cart to pay.
After the order is paid, the amount is added to the card. If a discount applied to the reload, the card gets the amount the customer actually paid.

Linking to the form with the card code¶
Add ?code= and the card code to the address of the page with the reload form, for example https://your-store.com/products/gift-card-reload?code=ABCD1234EFGH5678. The form opens with the code already filled in and checks the card straight away, so the customer only picks an amount. Print this link as a QR code on physical cards to let customers top up the card they are holding. The code is removed from the address bar once the form has read it.