Skip to content
DiscountOS Docs

App embed shows disabled

You turned the Promotions app embed on in the theme editor, but the app still shows Not enabled. Here is what the app is actually looking at, and how to settle it.

What the app checks

Section titled “What the app checks”

First, Shopify’s own answer. The app asks Shopify whether the Promotions embed is on in your published theme. That answer does not depend on your storefront, so a password page makes no difference. The app asks when the page opens and again whenever you come back to its tab — for example after saving the theme in the theme editor. When Shopify says the embed is on, the badge reads Enabled; when Shopify says it is not turned on, the badge reads Not enabled.

Fallback: the app’s own checks. Only when Shopify does not give a clear on-or-off answer does the app fall back to the checks below.

Your published storefront. The app opens your storefront’s home page and looks for the marker Shopify prints in the page for every enabled app embed. Finding it is a definite Enabled. The app re-reads that page at most once a minute per store, so an answer can be up to a minute old.

The embed reporting in. When the embed runs it reports in — from your published storefront, and from the theme editor preview the moment you toggle it on. A report in the last 10 minutes outranks a page reading that did not show the marker: the embed running is stronger evidence than a page that did not mention it.

When the page cannot be read. If your storefront is behind a password, or the request times out, the app does not guess. It falls back to the reports: a report within the last 48 hours reads as Enabled, and with no report at all the status stays undecided. These fallback checks are worked out when the Promotions page loads, so in that case reload the app to re-check. This is why, in the fallback, a password-protected store can show Not enabled while the switch in your theme is genuinely on — nothing has run yet for the app to hear from.

Fix it

Section titled “Fix it”

  1. Confirm the embed is on in the theme you have published.

    Theme editor → App embeds → Promotions on → Save. An embed enabled only in a draft or unpublished theme is not in what shoppers — or the app — see.

  2. Come back to the DiscountOS tab.

    The app asks Shopify again as soon as its tab has focus. If the status badge now reads Enabled, you are done. Steps 3 to 5 are only for the fallback, when Shopify gives the app no clear answer.

  3. Fallback only — open your storefront once with the embed on.

    Load a normal page of your storefront in a browser. If the storefront is password protected, enter the password first and then load a page. That one page view is what the embed needs to report in.

  4. Fallback only — wait a moment and reload the app.

    The storefront check is re-read at most once a minute, and the status is worked out as the page loads, so give it that long and then reload the Promotions page. The status badge should read Enabled.

  5. Fallback only — if it still disagrees, save the theme again from the theme editor.

    Opening the theme editor with the embed on makes it run in the preview, which reports in on its own — the fastest way to settle a stubborn status.

Limits and notes

Section titled “Limits and notes”
  • Turning the embed off is reported the same way. When Shopify answers, the badge follows it as soon as you come back to the app. In the fallback, the status can lag by up to 10 minutes after a disable, because a recent report outranks a marker-missing page for that long.
  • A spinner is not a failure. It means undecided — Shopify has not answered and the fallback has no verdict yet. It is capped at about 10 minutes from your Enable click; reload the app after that and it shows Not enabled rather than spin forever.
  • Nothing about your discounts depends on this status. Shopify still checks the cart and still applies your discounts. What the embed controls is the display: Sale Badges, Price Drops, and the gift added to the cart automatically.
  • The four widget blocks are unaffected. Quantity Break Table, Quantity Break Picker, Spend More Save More and Cart Goal Bar are theme blocks and render on their own.
Section titled “Related”