Dashboard & Analytics¶
The Analytics page shows how your gift card program is performing. To open it, go to the app's home page (Dashboard) and click View analytics in the Analytics card.

The page has the Gift cards view described in this article. If your store uses loyalty and promotions, a second tab, Loyalty & promotions, sits above it. That tab has its own article: Loyalty Analytics.
Permission
Analytics needs the read_all_orders permission. If it has not been granted, the page shows an Additional permissions required banner with a Give the app additional scope button instead of the figures.
Date range¶

Use the date range picker at the top left to set the reporting period. Pick a preset — Today, Yesterday, Last month, Last 7 days, Last 30 days or Last 90 days — or choose any start and end date on the calendar, then click Apply.
Last month is the previous calendar month, from the 1st to the last day. It is the period most merchants use to reconcile with Shopify.
Days start and end on your store's time zone (the one set in your Shopify admin), not your browser's. The charts and the CSV exports use the same time zone, so a late-evening order lands on the day your store sees it.
Key metrics¶

The top row shows four headline figures, each with a small trend line: Overall revenue, Redemption revenue, Redeemed gift cards and Avg gift balance. Below them, each metric has its own tile with a chart. Hover over a tile's title to read its definition.
All money figures are in your store currency. Gift cards that were issued from loyalty store credit are not counted in these tiles — they belong to the Loyalty & promotions tab.
Overall revenue by gift cards¶
The total value of gift cards issued in the selected period, with the number of cards sold, and a chart over time.
Gift cards queue¶
The latest gift cards scheduled or sent to recipients, with their status and order. Click View report for the full list, where you can edit or cancel scheduled sends and export to CSV.
Unused vs. used balance¶
A donut chart for the gift cards issued in the selected period: how much of their value is still unused, and how much has been spent.
Redeemed gift cards¶
The number of different gift cards that were spent from in the period.
Unused balance reminders¶
The latest reminders scheduled or sent to your customers, each marked Recovered (the customer used the card afterwards) or Not recovered. See Unused Balance Reminders for setup. View report opens the full list.
Redemption revenue¶
The value spent from gift cards in the period, limited to each card's balance, with a chart over time.
Redemptions amount¶
The total value redeemed from gift cards in the period. The bars split the period into equal slices.
Added to gift cards¶
The total value loaded onto gift cards in the period: newly issued cards plus top-ups. It covers every gift card in your store, not only cards issued by the app, so it reconciles with Shopify. The bars split the period into equal slices.
The same figure is split in two in the Gift Card Transactions report below: Issued and Topped up.
Sales lift¶
The extra revenue generated because customers spent more than their gift card value. For example, if a customer has a $50 card and spends $78, the lift is $28. An order fully covered by gift cards adds no lift.
Sales lift measures revenue beyond the face value of the cards.
Average gift balance value per order¶
The average amount of gift card value applied to an order in the period. It shows how much of a card customers typically use in one order.
Gift card balance checks¶
The number of balance checks customers made with the balance check widget, with the latest checks listed. View report shows all of them.
Orders paid with gift cards¶
The latest orders where a gift card was used as payment: order, date, subtotal, gift card, amount used and customer. Click an order or customer to open it in Shopify. View report opens the full list with a CSV export.
Gift cards in other currencies¶
If your store issues gift cards in more than one currency, a note appears above the tiles listing those cards per currency, with how many there are, how much they were issued with, and how much is left on them.
They are deliberately left out of the tiles: every figure on the dashboard is in your store currency, and adding EUR to JPY would produce a number in no currency at all. The note is there so the money is visible rather than silently missing. See Issuing cards in other currencies.
Gift Card Transactions report¶

A detailed transaction-level report of every gift card movement: issued value, top-ups, redemptions and balance changes. It needs the write_gift_card_transactions permission. If it has not been granted, the tile shows an Additional permissions required banner with a button to grant it.
Above the table, three figures cover the whole selected period — not just the page you are looking at:
- Issued — the face value of gift cards created in the period.
- Topped up — value added to existing cards: top-ups, adjustments, and credits back to a card from a refund.
- Redeemed — value spent from cards in the period.
Issuing a card is not a transaction in Shopify, so "how much value was loaded" is Issued + Topped up. The two are shown separately so you can tell a new card's face value from money added to a card a customer already had.
Filtering by customer¶
Use the Customer box at the end of the filter row to answer questions like "how much did I top up this customer's gift cards last month". Search by name or email (or paste a customer ID from the admin URL), and the report — the figures, the table and the CSV export — narrows to that customer's cards.
What "this customer's cards" means: a gift card belongs to a customer only when Shopify has one attached to it. Cards issued in bulk, imported, or created by hand without a buyer have no customer at all, and no report can attribute them to one. On many stores that is a large share of the cards, so an empty result here usually means the cards were never attached rather than that nothing happened.
All / Top-ups / Redemptions, between the date picker and the customer box, narrows the list to one kind of row. It narrows the list only: the three figures above always cover the whole period, so you can read a customer's top-ups against what they spent.
Cards are grouped, with each card's status, balance and initial value above its transactions. Each transaction shows its date, type (Top-up, Redemption or Order payment), a note or order name, the Branch, and the amount. Amounts are signed: + for value added to a card.
The Branch column shows the branch your till app sent when it redeemed the card through the REST API. Redemptions made at the Shopify POS till and online orders have no branch here and show a dash. The POS location of a redemption is recorded in the delivery log of redemption notifications instead. A card issued in another currency shows its balance and transactions in that currency, marked with the currency code next to the card.
Both filters are kept in the page URL, so a filtered report can be bookmarked or pasted into a message to a colleague. Click a card's number to open it in Shopify.
CSV export¶
Export to CSV downloads every row in the period (not just the page), with the customer filter applied if one is set. These columns help with reconciling:
- Type —
Credit(value added),Debit(value spent), orOrder(Shopify's order-side copy of a spend). - Branch — the branch your till app sent when it redeemed the card through the REST API, empty for every other row.
- Customer ID — filled in when the export was filtered to a customer.
Top customers report¶

Answers the other half of the question: not "this customer", but who the store loaded gift card value onto in the period. Each line shows a customer, the cards issued to them in the period, their face value, and everything topped up onto their cards. Use Sort by to order by Topped up or Issued, and click a line to open the Gift Card Transactions report filtered to that customer and period.
Unassigned cards appears as its own line at the end of the table. These are the cards with no customer attached — bulk, imported or manually issued. They are shown rather than dropped, because on most stores they carry a large part of the loaded value: without that line, the column would not add up to the Added to gift cards tile for the same period.
Redemptions are deliberately not part of this report. Spends are recorded twice by Shopify (once by the gift card, once by the order), and only the transactions report untangles that reliably — so for what a customer spent, open their line and read it there.
Data sync¶
Analytics reads a copy of your Shopify data that Gift Card Hero keeps up to date in the background. The sync status is shown as a progress banner while a sync is running.
Triggering a sync¶
Click Sync Data at the top right of the page and choose:
- Sync for period — syncs data for the selected date range only
- Sync for all time — syncs all historical data from the beginning (use this after first install or if data looks incomplete)
Progress is shown as a percentage. You can leave the page — the sync continues in the background. If a sync stalls, a Cancel sync button appears so you can stop it and try again.
Tiles blurred as "Not synced for this period"¶
If the copy of your data does not cover the period on screen — it has never been synced, or you picked dates outside the range of the last "Sync for period" — the figures would show a confident $0.00 that looks like a quiet month but is really missing data. Instead, the tiles are blurred and an Analytics not synced for this period banner explains why.
Click Start sync in the banner (or Sync data on the large revenue tile) to fill the gap. The tiles clear when the sync finishes. A sync for all time covers every period.
A softer Sync recommended banner appears when the period is covered but the last sync is more than a week old. The figures are not blurred in that case.
The Gift cards queue, Unused balance reminders and Gift card balance checks tiles are live and are never blurred.

First install¶
After installing Gift Card Hero, the dashboard shows blurred tiles until the first sync completes. Run Sync for all time. Stores with a long order history take longer.
Full reports¶
View report on a tile opens the full report page, with its own date range and, where it makes sense, a CSV export. Reports are available for the gift cards queue, unused balance reminders, balance checks, orders paid with gift cards, Gift Card Transactions and Top customers.
Looking for a list of every card that still has a balance? See Gift Card Balance Reports.
Understanding your numbers¶
The tiles are blurred¶
The copy of your data does not cover the selected period. Click Start sync. See Tiles blurred as "Not synced for this period".
Sales lift shows 0 or very low¶
Sales lift is the part of an order above what the gift card paid. If customers use cards that cover the entire order (for example a $25 card on a $25 order), lift is zero. This is normal for low-denomination cards or high-value baskets.
Totals look lower than expected on a multi-currency store¶
Cards issued in a currency other than your store currency are not counted in the tiles — they are reported in their own note above them. This is by design; see Gift cards in other currencies.
Loyalty store credit is missing¶
Store credit from your loyalty program is not counted in the Gift cards view. It has its own tab, Loyalty & promotions. See Loyalty Analytics.
Redemption revenue doesn't match Shopify's reports¶
Gift Card Hero syncs data from Shopify's API. Minor differences can occur due to sync timing or orders that were edited after being placed. Run a manual sync to refresh.