storefront theme

Place Badgy blocks in your theme

Learn how to place Badgy blocks in your theme with a safe Juniper & Trail example, shopper impact, options, and recovery checks. Use the global app embed for the storefront runtime and place supported theme blocks where the theme exposes compatible sections. Save the theme and test collection and product contexts because their data differs.

Before you begin

Theme-editor access
A published theme or safe duplicate for testing
Desktop and mobile storefront preview access

Confirm the shop, current status, and intended consequence before changing anything. Use read-only status, preview, or history evidence first.

Step-by-step setup

Place Badgy blocks in your theme shown in the Badgy admin, with numbered callouts for the controls and verification points described below. — Annotated Juniper & Trail example

Choose the banner template and give this banner a recognizable name.
Use Design and Placement to switch between appearance and location controls.
Configure the banner background, optional image, and link behavior.
Review the live desktop banner preview before saving.

Open the Shopify theme editor for the intended shop and confirm the current record and status.
Keep the global app embed enabled and add supported Badgy blocks to compatible product/collection/home sections where needed.
Read the inline summary, warning, or preflight before submitting; do not repeat a command while background work is running.
Test product context, collection cards, home page, quick view, and mobile after Save.
Confirm the resulting status and History/audit evidence, then spot-check Shopify or the storefront when the action has external effects.

Use the global app embed for the storefront runtime and place supported theme blocks where the theme exposes compatible sections. Save the theme and test collection and product contexts because their data differs.

Juniper & Trail example

Juniper & Trail verifies place badgy blocks in your theme on its home page, collection grid, and Ridgeway jacket product page in desktop and mobile previews. The documentation fixture uses realistic products, inventory states, variants, collections, and protected exclusions so the preview exercises the same decisions as a merchant catalog.

What shoppers will see

Sticky bottom banner with compact 56 px treatment in the Juniper & Trail storefront, marked with one focused verification callout. — Annotated Juniper & Trail example

Confirm the campaign announcement and Shop call to action at the top of the store.
Check the badge and adjusted pricing on an eligible product card.
Compare another product card to verify consistent campaign treatment.

Confirm the campaign announcement and Shop call to action fit the mobile header.
Check that the badge remains readable on the mobile product card.
Scroll through additional products to verify the collection layout stays usable.

Theme extensions read Badgy campaign metafields and show nothing when eligible configuration is absent. Check the relevant result from product through cart where applicable. For shopper-facing work, compare desktop and mobile and verify both an eligible and an ineligible item.

Common mistakes and troubleshooting

Acting on the wrong shop. Confirm the Shopify store and campaign before following Place Badgy blocks in your theme.
Trusting a stale preview. Refresh after catalog, schedule, discount, theme, locale, or market changes.
Repeating a background command. Read status and History first; retry only when Badgy presents a recoverable failure.
Checking only one viewport. Verify desktop and mobile in a private storefront window.

If the status reports revoked authorization, reconnect Shopify before retrying. If the result still differs from the preview, preserve the campaign ID and approximate time, then open support from this identified shop. Never send customer data, access tokens, or full catalog exports in feedback.

Options reference

| Option | Use it when | Consequence | | --- | --- | --- | | App embed | Load global runtime/config | Required supported foundation | | Theme block | Place section content | Theme determines available locations | | Duplicate theme | Test placement safely | Publish after review |

Badgy behavior in this guide is reviewed against the repository's shipped UI, service rules, and feature design documents. Shopify-owned theme, Markets, Flow, billing, and discount behavior can also depend on the store's Shopify configuration; consult the Shopify Help Center for that platform configuration.