> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Promo popup

> An email signup dialog that opens after a delay, once per visitor, and can show a discount code after signing up. Off on install.

![Promo popup on the storefront](https://mintcdn.com/kwebby/tbWCv70mkhaUy_7w/images/kelvin/promo-popup.webp?fit=max\&auto=format\&n=tbWCv70mkhaUy_7w\&q=85\&s=dd6c68a78a6da8da8e2b237beec64ba9)

Promo popup, highlighted with the demo content

## Where to find it

The Overlays group. It ships hidden: in the theme editor open any page, find Promo popup under Overlays in the sidebar, and click the eye icon to show it. There can be only one; if you deleted it, add it back with Add section in the Overlays group.

## How it works

* It opens Open after seconds (0 to 60, 8 by default) after a page loads, on every page except the cart and the account page, or only on the home page when Show on is Home page only.
* It never opens on top of another dialog: while the cart drawer, a menu, quick view or the age verifier is open, it waits and tries again a little later.
* Closing it with the close button, No thanks, Escape or a click outside keeps it away on that device for Show again after it is closed (1 to 90 days, 14 by default).
* Signing up saves the visitor as a customer who accepts marketing, tagged newsletter and popup. Shopify reloads the page and the popup opens straight away with the Message after signing up and, when you set one, the discount code with a Copy code button. It never opens by itself again on that device.
* The address is checked before it is sent, and Shopify's errors show under the field with the popup open.
* The discount code is only in the page after a signup. The theme does not create the code, check that it exists, or email it.
* An Image sits beside the text on screens 750 px and wider, and above it, cropped wide, on phones.
* With Show email signup off it is a plain announcement with No thanks.
* In the theme editor it opens only while the section is selected.

![Promo popup in the theme editor](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/editor-promo-popup.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=186097b32254114e3111192c4829118a)

In the theme editor: 1 Promo popup, under Overlays, hidden on install (the eye icon) · 2 its settings

## Edit it

* Create the discount in Discounts first, then type it exactly in Discount code shown after signing up and edit Text above the code.
* Write a Heading and Text that say what subscribers get and how often you write.
* Keep Open after at 8 seconds or more so visitors see the page first.
* Edit Note under the field with how often you email and how to unsubscribe.
* Show the section with the eye icon in the sidebar, then save.

## Settings

> [!TIP]
>
> An email signup that opens after a delay, once per visitor until it is closed again after the days you choose. Never shown on the cart or account pages. Off when the theme is installed: show this section in the Overlays group to turn it on.

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 2. |
| **Show on** | Options: Every page except cart and account, Home page only. Default: Every page except cart and account. |
| **Open after** | Slider from 0 to 60 s. Default: 8 s. |
| **Show again after it is closed** | Slider from 1 to 90 d. A visitor who signs up never sees it again on that device. Default: 14 d. |

**Content**

| Setting | What it does |
| - | - |
| **Image** | Image: upload one or choose from Content → Files. 800 x 800px recommended. |
| **Label** | Text. Default: Deal alerts. |
| **Detail beside the label** | Text. |
| **Heading** | Text. Default: Hear about price drops first. |
| **Text** | Formatted text. |

**Email signup**

| Setting | What it does |
| - | - |
| **Show email signup** | On or off. Signups are saved as customers who accept marketing, tagged newsletter and popup. Default: on. |
| **Button label** | Text. Leave empty to use “Sign up”. |
| **Note under the field** | Text. Default: Say how often you email and how to unsubscribe. |
| **Message after signing up** | Text. Leave empty to use “Thanks. You're on the list.”. |
| **Discount code shown after signing up** | Text. Create the code in Discounts first. Leave empty to show no code. |
| **Text above the code** | Text. Default: Use this code at checkout:. |

> [!NOTE]
>
> On install, Text and Note under the field hold guidance, not words for shoppers: replace them with what subscribers get and how often you really email.
>
> Whether a visitor closed the popup or signed up is saved on their device: after clearing the browser's site data they see it again.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.