Why an installed popup can remain invisible

Shopify uses app embed blocks for floating or overlaid storefront components. Shopify deactivates these embeds by default after installation so an app cannot silently add a customer-facing overlay without merchant approval.

This design protects theme control, but it creates a common misunderstanding: the app admin says the campaign is live while the published theme has never loaded the storefront runtime. Shopify explains the behavior in its theme app extension configuration documentation.

Enable the embed step by step

  1. Open your Shopify admin.
  2. Go to Online Store → Themes.
  3. Find the theme marked Current theme.
  4. Select Customize.
  5. Open Theme settings.
  6. Select App embeds.
  7. Find the PrimePopup or relevant popup embed.
  8. Turn the embed on.
  9. Select Save and wait for the save confirmation.
Use the app’s activation deep link when available.

A deep link can open the correct theme-editor panel, but the merchant should still confirm the toggle and save the theme.

Check the published theme—not only a preview theme

Shopify stores can contain several theme copies. An embed enabled on a development, duplicate, or preview theme does not imply that it is enabled on the current published theme.

  • Look for the Current theme label in Shopify Admin.
  • Confirm the theme name matches the theme editor you opened.
  • Save the embed change.
  • Open the actual storefront domain, not only the editor preview URL.

If the merchant publishes a different theme later, repeat this verification because the new theme can have a different app-embed state.

Verify that activation reached the storefront

Do not verify only by looking for a popup. A correctly active embed may decide not to display a campaign because the current page, visitor, schedule, frequency, or trigger is ineligible.

  1. Confirm the app onboarding or diagnostics reports the embed as enabled.
  2. Open a known eligible page.
  3. Use a fresh session or the app’s storefront test mode.
  4. Wait for the configured trigger.
  5. Check the browser network log for the app decision request.
  6. Check the app diagnostic reason if the response says not to display.

Recheck the embed after storefront changes

Review activation after publishing a new theme, reinstalling the app, moving between development and public app installations, cloning a store, or changing the app extension version. These actions can leave the campaign data intact while changing which storefront theme loads the extension.

A good onboarding checklist should treat embed activation as observable state, not a one-time instruction the merchant must remember forever.

If the embed is enabled and the popup is still hidden

Continue with the complete Shopify popup not showing checklist. Confirm live campaign version, schedule, page and audience eligibility, frequency suppression, trigger progress, consent, decision request, and rendering—in that order.

Do not repeatedly uninstall and reinstall unless diagnostics show an installation problem. Reinstallation can erase test data without correcting a page, frequency, or trigger rule.