Balance Check Widget — Configuration¶
The Configuration page controls the balance check widget for your storefront. Go to Balance Widget in the left navigation.
Enable / disable¶
The status badge at the top shows whether the widget is Enabled or Disabled. Click the toggle button to switch.
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¶
GiftCard 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>
GiftCard Hero's storefront script detects this element and injects the widget into it automatically.
Widget behavior options¶
These checkboxes control what happens after a customer enters their gift card code:
| Option | Description |
|---|---|
| Offer products at a similar price to card balance | After a balance check, show product recommendations priced near the card's remaining value |
| Show main toggle button bubble | Display a floating action button on the page that customers can click to open the widget |
| Allow applying card balance to cart from widget | Let customers apply their gift card to the cart directly from the widget, without going to checkout |
| Show cart / balance progress bar | Display a progress bar showing how much of the card's balance covers the current cart total |
| Show cart / balance progress bar on cart change | Update the progress bar automatically as cart contents change |
| Allow applying multiple gift cards | Let customers apply more than one gift card at a time |
The progress bar options are only active when Allow applying card balance to cart is enabled.
Auto-open on page load¶
Enter the number of seconds after which the widget opens automatically (e.g., 5 = opens 5 seconds after page load). Set to 0 (or leave blank) to require the customer to open it manually by clicking the toggle button bubble.
Widget text and design¶
To customize the widget's heading and surrounding text, go to the Look and Feel sub-page (accessible from the Balance Widget section in the navigation).
There you can set:
- Title — the heading displayed above the widget
- Text before widget — HTML content shown above the balance check input
- Text after widget — HTML content shown below the input
