Promo Selector
The Promo Selector block presents a “Choose your free gift” dropdown populated by free_gift_option metaobjects. Each option shows a product thumbnail, title, and either a promotional price override or the original price struck through. When a customer selects a gift, its variant is added to the cart bundle at price zero. The selection clears automatically after a successful cart submission.
Settings
Section titled “Settings”| Setting | What it does |
|---|---|
| Heading | The bold label above the dropdown. Defaults to “Choose your free gift”. |
| Placeholder text | The text shown in the closed dropdown before a selection is made. Defaults to “Select a gift”. |
| Warning text | The validation message shown when the form is submitted without a gift selected. Defaults to “Please select a free gift”. |
| Gift options | A list of free_gift_option metaobjects. Connect via dynamic source from the nama.free_gift_options product metafield. |
Used in
Section titled “Used in”- Gift product images are pulled from the
nama.product_card_imagesmetaobject for consistency with the rest of the storefront, falling back to the product’s featured image. - Titles prefer the
nama.product_alternate_titlemetafield, so the dropdown label can differ from the admin product name. - Like the Bundle Checkbox block, selections dispatch a
bundle:updateevent that the Product Form Submit block handles transparently. - The dropdown border turns kale when a gift is selected and berry when the warning state fires.