getting started

Enable the Badgy theme app embed

Learn how to enable the Badgy theme app embed with a safe Juniper & Trail example, shopper impact, options, and recovery checks. Open Shopify's theme editor for the published theme, enable the Badgy app embed, save, and return to the Storefront status card. A Couldn't verify result is not confirmation; check the storefront directly.

Before you begin

• A Shopify staff account allowed to open installed apps
• Access to the published theme when the guide changes storefront rendering
• A small, reversible product set for the first campaign

Keep the campaign in Draft while you verify the configuration. Use a private storefront window where the guide changes shopper-facing behavior.

Step-by-step setup

Open full size ↗

1. 1

   Choose the banner template and give this banner a recognizable name.

2. 2

   Use Design and Placement to switch between appearance and location controls.

3. 3

   Configure the banner background, optional image, and link behavior.

4. 4

   Review the live desktop banner preview before saving.

1. From Badgy's Storefront status, open the Shopify theme editor for the published theme.
2. Open App embeds and enable Badgy.
3. Save the theme; an unsaved toggle is not active.
4. Return to Badgy and refresh the status until it reads On, or verify directly if it reads Couldn't verify.
5. Open a private desktop and mobile storefront preview with an active controlled campaign.

Open Shopify's theme editor for the published theme, enable the Badgy app embed, save, and return to the Storefront status card. A Couldn't verify result is not confirmation; check the storefront directly.

Juniper & Trail example

Juniper & Trail uses a controlled Weekend Trail Kit draft and the published theme's app embed. The team verifies the shop name before it previews enable the badgy theme app embed. 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

Open full size ↗

1. 1

   Confirm the campaign announcement and Shop call to action at the top of the store.

2. 2

   Check the badge and adjusted pricing on an eligible product card.

3. 3

   Compare another product card to verify consistent campaign treatment.

Open full size ↗

1. 1

   Confirm the campaign announcement and Shop call to action fit the mobile header.

2. 2

   Check that the badge remains readable on the mobile product card.

3. 3

   Scroll through additional products to verify the collection layout stays usable.

Nothing appears to shoppers until the campaign is active and the required theme rendering is enabled. 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 Enable the Badgy theme app embed.
• 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.
• Skipping the consequence check. Confirm what changes for shoppers and what the end or restore path will do.

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.

Related guides

• First campaign

Options reference

| Option | Use it when | Consequence | | --- | --- | --- | | On | Embed was verified enabled | Badgy can render eligible content | | Off | Embed was verified disabled | Enable and save in theme editor | | Couldn't verify | Theme inspection was inconclusive | Check the published theme directly |

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.