> For the complete documentation index, see [llms.txt](https://docs.webexp.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webexp.dev/supra-shopify-theme/supra/sections-and-features/popup.md).

# 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.