Skip to content

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).

Widget configuration


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.

Widget look and feel

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.

Balance widget texts

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