Balance Check Widget — Configuration¶
The Balance check widget page controls the balance check widget for your storefront. Go to Balance widget in the left navigation.
The buttons at the top right lead to the other two places that shape the widget: Change design (colors) and Translations (texts).

Enable / disable¶
The status badge shows whether the widget is Enabled or Disabled. Click Enable or Disable to switch, then save in the bar at the top of the page. New stores start with the widget disabled.
When the widget is disabled, the balance check page and the embed code are both inactive — no widget appears on your storefront.
Balance check page¶
Gift Card Hero provides a hosted balance check page accessible at:
https://[your-store].myshopify.com/a/gifthero/balance
Use the Copy button to copy the URL, or Open page to preview it in a new browser tab.
Embedding the widget¶
To embed the balance check widget anywhere in your storefront, add this HTML to the target page:
<div class="sc-hero-checker-container"></div>
When you paste it into a Shopify page or blog editor, use the <> (Show HTML) button in the editor so the code is saved as HTML and not as text.
Gift Card Hero's storefront script detects this element and injects the widget into it automatically.
Widget behavior options¶
These options control what happens after a customer enters their gift card code. Each is a checkbox unless stated otherwise:
| Option | Default | Description |
|---|---|---|
| Offer products at a price similar to a card balance | On | After a balance check, show product recommendations priced near the card's remaining value |
| Show main toggle button bubble | On | Display a floating button on the page that customers click to open the widget |
| Allow to apply card balance to a cart from widget | On | Let customers apply their gift card to the cart directly from the widget, without going to checkout |
| Show cart/balance progress bar | On | Display a progress bar showing how much of the cart total the card's balance covers |
| Show cart/balance progress bar on cart change | On | Show the progress bar again when the cart contents change |
| Show progress on cart change (seconds) | 4 | How long the progress bar stays visible after a cart change |
| Allow to apply multiple gift cards | On | Let customers apply more than one gift card at a time |
| Show widget opened on first page load (seconds) | 5 | How many seconds after the page loads the widget opens by itself |
Dependent options
The three progress options are available only while Allow to apply card balance to a cart from widget is ticked. The Show progress on cart change time is available only while Show cart/balance progress bar on cart change is ticked.
Auto-open on page load¶
Show widget opened on first page load takes a number of seconds (for example 5 opens the widget 5 seconds after the page loads). Enter 0 to keep the widget closed until the customer clicks the toggle button bubble.
Different page layout on some stores
On some stores this page shows a shorter layout: the balance check page link and embed code, followed by Title, Text before widget and Text after widget fields, without the checkboxes above and without the Enable button. If that is what you see, edit those fields instead; the behavior options above do not apply to that layout.
Look and feel¶
Click Change design to open Balance widget look and feel. A live preview of the widget is on the left and the style controls are on the right.

| Section | What you can change |
|---|---|
| Overall widget styles | Widget background, Widget font color, and Gift card border radius |
| Gift card balance form | Code input background, Code input border, Code input font, Check button background, Check button border, Check button font, Check button border radius and Input border radius |
Save in the bar at the top of the page.
Texts and translations¶
Click Translations to open Settings → Translations with the Balance widget area selected. There you can change every label and message in the widget: the input label and placeholder, the check button, the Apply button, the Check another card button, the status pills, the transaction history title and the error messages. Choose the language to edit from the language selector.

See also Balance Check Widget for how the widget works for customers.