For the complete documentation index, see llms.txt. This page is also available as Markdown.

Popup

The mailing list, in a box over the page.

The same sign-up the footer carries, in a box over the page. A signup here lands in the same place, carries the same tag and shows the same confirmation — there is nothing new to connect.

It lives in the Footer group, so it is on every page without being added to any. Find it in the theme editor under Footer → Popup.

When it appears

Most of the work here is in when it does not.

Rule
Why

Never on the password page

Nothing to sign up to yet

Waits for the Enter Page

A shop that opens with a gate has already asked once. Asking twice before the visitor has seen anything is how a popup earns the reflex to close it

Open after a delay

Counted from when the page is ready, or from when the Enter Page is passed. 5 seconds by default

Leave closed for N days

After someone closes it. 14 by default

Never again after a signup

Recorded from the confirmation, so it only counts when the signup actually worked

Closing it is remembered in the visitor's own browser, so clearing site data brings it back. Nothing about this is stored against them anywhere else.

What it looks like

The page behind is softened rather than darkened — a light wash and a small blur, the same treatment the category dropdown uses. A dark sheet over a white shop reads as the lights going out; the page behind is still the shop and should look put aside rather than switched off.

Signing up

The box turns into its own receipt rather than the page reloading. The ask leaves, the field goes with it, and the confirmation takes the top of the box with the offer and code underneath.

If a browser is running no scripts at all, the form posts the ordinary way and the same confirmation comes back on the page that follows.

The popup only ever repeats what Shopify said. If a signup is refused with a reason, the reason is shown. If something fails without one, the box says nothing, the button comes back and the address stays in the field — a visitor whose signup worked is never told it did not.

The discount code

Optional. Leave Code empty and it is plain sign-up with no offer.

Filled in, the confirmation shows the code as a button — tapping it copies it, which is what anyone reading a code on a phone is about to do by hand. It stays selectable for anyone who would rather read it.

The theme does not create the discount. Set it up in Discounts first and put the same code here. What the code is worth is a line you write — the theme has no way to look up what your discount actually does and does not pretend to.

Settings

Setting
Default

Heading

Join the list

Text

Drop announcements and restocks, straight to your inbox.

Image

none — sits above the text on a phone, beside it on a desktop

Field placeholder

email address

Button

Subscribe

Small print

empty — unsubscribe wording, or how often you send

Code

empty

What the code is worth

10% off your first order

Wording before the code

Use code

Open after

5 seconds

Leave closed for

14 days

Tag applied to signups

newsletter

The tag is what lets you tell popup signups from footer ones in Customers.

Editing it

Selecting the section in the theme editor opens the popup whatever the delay says and whatever you dismissed earlier, and it stays up while you work — changing a setting re-renders the section, and without this it would close itself on every keystroke.

Nothing you do in the editor is recorded as a real dismissal, so closing it while building it will not make it vanish from your own storefront for a fortnight.

Last updated