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 gift card code
  3. The widget shows the current balance and expiry date (if one is set)

Balance check widget on your storefront

Balance check result

Balance check page

Every store gets 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>

GiftCard Hero's script injects the widget into this container automatically.

Configuration

To enable the widget and set its behavior, go to Balance Widget (or Configuration) 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 the card to their cart from the widget
  • Cart progress bar
  • Auto-open delay
  • Text and title customization

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

Balance looks stale after a recent redemption - The widget caches balance lookups briefly. A customer who checks immediately after redeeming a card may briefly see the pre-redemption balance. This resolves itself within a minute.