gift-card-balance
(HQ #73) A form where the visitor types a gift card code and reads its balance, without buying anything: Smootify asks Shopify with a throwaway cart that carries only that code, never the visitor's cart. On success [gift-card="balance"] and [gift-card="code"] are written (§2.11) and `[form-done]` shows; an unknown, disabled or expired code shows the form error, and so does a card used up: Shopify applies no card with a zero balance, the same answer as an unknown code (checked on the starter, 2026-10-16; beta.4's is-empty never showed and is gone). Every plan. Inside smootify-cart too (next to its gift card field): the cart never takes its form, field or form states as its own, as with a smootify-product.
Where it can go
- Anywhere on the page.
- Must contain
form. - Out of place, Smootify removes it from the page.
What it requires
Nothing beyond Smootify: it works on every plan.
Fields in the form
Each field’s name attribute tells Smootify what the field holds.
| Name | Field | What it does |
|---|---|---|
a field named code, gift card, gift-card, gift_card, giftcard, giftcardcode or gift card code (any case), else the first one filled | input type="text" | Required (the not-found error without it). The gift card code, trimmed, in any case (Shopify ignores case); every other field is ignored. |
Attributes on the element
- It reads
data-error-not-found.
Attributes inside it
| Group | Attribute name | Values |
|---|---|---|
| Gift card | gift-card | 3 |