Balance Check Widget¶
The balance check widget lets customers enter their gift card code on your storefront and instantly see their remaining balance — without going to checkout.
This reduces "how much is left on my card?" support requests and gives customers confidence before they shop.
How it works¶
- Customer visits your store's balance check page or an embedded widget
- They enter their full gift card code and click the check button
- The widget shows the current balance, the card's status, whether it expires, and its transaction history
The balance is read from Shopify at the moment the customer checks, so it is current. The last few characters of a code are not enough — the whole code is needed, which keeps other people's cards private.


Depending on your settings, the widget can also suggest products priced near the card's balance, let the customer apply the card to their cart, and show how much of the cart the card covers.
Balance check page¶
Once the widget is enabled, your store has a hosted balance check page at:
https://[your-store].myshopify.com/a/gifthero/balance
Share this link in your gift card emails, navigation menu, or anywhere customers might look for it.
Embedding the widget on any page¶
You can also embed the widget directly in your storefront by adding this HTML element where you want it to appear:
<div class="sc-hero-checker-container"></div>
Gift Card Hero's script injects the widget into this container automatically.
Configuration¶
To enable the widget and set its behavior, go to Balance widget in the left navigation. See Widget Configuration for the full settings reference, including:
- Enabling / disabling the widget
- Product recommendations after a balance check
- Allowing customers to apply one or several cards to their cart from the widget
- Cart progress bar
- Auto-open delay
- Page title and texts, colors, and translations
Sharing the balance check link¶
Good places to share the balance check URL:
- The "Check Balance" button in the gift card delivery email
- Your store navigation ("Gift Cards" or "Check Balance" menu item)
- Order confirmation and shipping notification emails
- Your customer account page
Customer account balance view¶
Customers logged in with a Shopify account can see all their gift cards — including balances — in the My Gift Cards section of their customer account portal. See Customer Account Portal for details.
Troubleshooting¶
Widget doesn't appear
- Confirm the widget is enabled in Widget Configuration
- If using the embed method, check that <div class="sc-hero-checker-container"></div> is present in the page source
- Hard-refresh the page (Cmd/Ctrl + Shift + R) to bypass Shopify's theme cache
- Check if theme extension is enabled for your theme
The widget finds no card for a code that looks right - The widget looks cards up by the full code. Make sure the customer typed all of it, without missing or extra characters. - Check that the card is not disabled in Shopify.
Balance looks out of date - The widget reads the balance from Shopify each time the customer checks. Ask them to check again, and hard-refresh the page if the old figure is still shown.