How do I turn on the app embed?

The app embed is a switch that adds the app's display feature to your store's design. If it is off, popups will not appear on your store.

  1. Open the theme editorIn the left menu of your Shopify admin, click Online Store to open the Themes page. Click "Edit theme" (shown as "Customize" on some screens) on your current theme to open the theme editor. You can also open it with the 「テーマエディタを開く」 (Open theme editor) button at the top of the popup list in the app.
  2. Open App embedsIn the left side of the theme editor, select App embeds.
  3. Turn on the popup and saveTurn on Popup Banner's 「ポップアップ」 (Popup) embed, then click Save in the top right. Make sure you are editing your current (published) theme.

Steps to deliver your first popup

To open the app, go to Apps in the left menu of your Shopify admin and select Popup Banner. The app's left menu has 「ポップアップ」 (Popups) and 「料金プラン」 (Pricing plans).

  1. Create a new popupOn the list page, click 「ポップアップを作成」 (Create popup), set a popup name and image, and add a link URL if needed. An image is required. A newly created popup is set to 「無効」 (Inactive), so customers do not see it.
  2. Choose a positionChoose the center or one of the four corners of the screen.
  3. Set the conditionsStart with simple conditions, such as the trigger 「ページ読み込み直後」 (Right after page load), pages 「全ページ」 (All pages), and device 「すべてのデバイス」 (All devices).
  4. Save it as inactive and check itStatus and priority are on the right side of the edit page. Keep the status as 「無効」 (Inactive), save, and check the image and position in the edit page preview. The edit page shows a note saying that after saving, the popup appears once you switch it to 「有効」 (Active) in the list. Once you make it active, customers will see it right away.
  5. Switch it to activeWhen everything looks right, use the row menu (⋯) on the list page to switch the status to 「有効」 (Active). You can also set the status to 「有効」 (Active) on the edit page and save. Setting changes can take about 15 seconds, and up to about 30 seconds, to show on your store. Reload any page you have open to see the change. If you open your store in a private (incognito) window, which keeps no browsing history, past close records will not affect what you see. If your store is password protected, enter the password before checking.

What to check before going live

  • The app embed is turned on in your current theme
  • The image, alt text, and link URL are correct
  • The popup can be closed
  • The popup does not cover too much of the screen on smartphones
  • The priorities of multiple active popups are set correctly

Common stumbling points for first-time users

I turned it on in a theme that is not published
The app embed is set per theme. Turning it on in a draft theme does not show popups on your store. On the Themes page, open your current theme and check there.
My popup stopped showing after I downgraded my plan
When you downgrade, popups that use settings not available on the new plan (URL path targeting, specific products, products in specific collections, display period, display limit, A/B testing, and so on) stop being delivered. The list page shows the reason as 「プラン制限で停止中」 (Paused by plan limits). The settings are not deleted. If you return to your previous plan, or change that setting and save, delivery resumes automatically.
I can't check it on a password-protected store
Before launch, your store shows a password page when you open it. Enter the password, and you can check how the popup appears.
Deleting a popup also deleted its data
Deleting a popup also deletes its tracking data and the image saved in Shopify Files, and this cannot be undone. However, if another popup (such as a duplicate) uses the same image, the image is kept. If you want to keep them, set the popup to 「無効」 (Inactive) instead of deleting it.
The popup is active but does not appear on my store
The app embed may not be turned on in your theme. The notice banner on the list page does not detect the app embed status automatically; it simply stays until you close it. Closing the banner does not turn the embed on, so check App embeds in the theme editor. For other things to check, see "When Popup Banner is not showing".
I can't make a second popup active
On the Free plan, you can have only 1 active popup. If you try to go over the limit, you see the error 「フリープランで有効にできるポップアップは1件までです。プランをアップグレードするか、他のポップアップを無効にしてください」 (On the Free plan, you can have up to 1 active popup. Upgrade your plan or deactivate other popups). Deactivate another popup or change your plan.
I can't select the display condition I want
Showing on scroll, specific products or collections, URL path targeting, display period, and display limits are available on Basic and above. Showing when a visitor is about to leave the page, and A/B testing, are available on Pro. Options not available on your plan cannot be selected, and the required plan is shown next to the option name.
The impressions and CTR columns in the list show no numbers
Viewing tracking data (impressions, clicks, closes, CTR) is available on Basic and above. Tracking continues on the Free plan, so when you move to Basic or above, you can see the data collected so far.
After I closed it once, it no longer shows in my browser
The closed state is saved per browser, and clicking the link also counts as closing. To check the display again, use another browser or a private (incognito) window. 「非表示状態をリセット」 (Reset hidden state) affects all customers, so be careful about using it just for testing.
It does not show on smartphones
The trigger 「ページを離れようとした時」 (When about to leave the page) works on PCs only. Also check that the device setting is not 「PCのみ」 (PC only). Devices are detected by screen width: 749px or less counts as mobile, and 750px or more counts as PC, even on tablets.