Skip to content

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

  1. Customer visits your store's balance check page or an embedded widget
  2. They enter their full gift card code and click the check button
  3. 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.

Balance check widget on your storefront

Balance check result

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

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.