> For the complete documentation index, see [llms.txt](https://aries-theme.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aries-theme.gitbook.io/docs/group-sections/overlay-group/popup.md). # Popup The Popup section shows a modal window to visitors at a moment you choose; for example after a short delay, when they scroll partway down the page, or when they move to leave. Use it to grow your email list with a signup form, promote a discount, or highlight a call-to-action. You control when it appears and how often, so it can feel helpful instead of intrusive.
{% hint style="info" %} ### How to set it up 1. Go to **Online Store > Themes > Customize**. 2. The Popup section lives in an overlay group. If you don’t see it, check **Sections** in the left sidebar and look for **Popup**, or add it from the section list if your theme allows. 3. Turn **Enable popup** on and, if you want to design it without triggers, turn **Test mode** on. 4. Preview on different devices, then click **Save**. {% endhint %} ### Settings * **Enable popup**: Turns the popup on or off. When off, the popup never shows, no matter how the rest of the settings are configured. * **Test mode**: When enabled, the popup stays visible on screen and ignores all trigger and frequency rules. Use this to design and preview the popup; turn it off before publishing. * **Popup trigger type**: Decides when the popup appears. **Delay** shows it after a set number of seconds on the page. **Scroll percentage** shows it when the visitor has scrolled to a given percentage of the page. **Exit intent** tries to show it when the visitor moves the cursor as if leaving the page (e.g. toward the browser tab or address bar). * **Show delay (seconds)**: How many seconds to wait after page load before showing the popup. Only used when Popup trigger type is **Delay**. * **Scroll percentage**: The percentage of the page the visitor must scroll to before the popup appears. Only used when Popup trigger type is **Scroll percentage**. * **Frequency type**: How often the same visitor can see the popup. **Once per session** shows it at most once per browser session. **Once per day** or **Once per week** limits it to once per day or week. **Custom (days)** uses the “Days between shows” value below. * **Days between shows**: Number of days to wait before showing the popup again to the same visitor. Only used when Frequency type is **Custom (days)**. * **Image**: Optional image shown next to the popup content on desktop. Improves visual appeal and can reinforce your message. * **Image position**: Puts the image on the **Left** or **Right** of the content. The image is shown on desktop only; on mobile it is hidden. * **Color scheme**: Sets the background and text colors for the popup so it matches your theme or stands out as you prefer. *** ### Blocks #### Heading * **Heading**: The main title inside the popup (e.g. “Subscribe” or “Get 10% off”). * **Heading size**: Size of the heading (S, M, or L). * **Underline**: When enabled, adds an underline under the heading. #### Text * **Text**: Body text below the heading. Use it to explain the offer or why visitors should sign up. * **Text size**: Size of this text (4XS, S, M, L, XL). #### Email form * **Button style**: Whether the submit control is shown as **Icon** or **Text**. * **Show consent checkbox**: When enabled, adds a checkbox so visitors can agree to marketing before subscribing. Useful for compliance (e.g. GDPR). * **Consent text**: The text shown next to the consent checkbox (e.g. “I agree to receive marketing communications.”). Visible when the consent checkbox is on. * **Privacy policy URL**: Link to your privacy policy. Visible when the consent checkbox is on. * **Privacy policy link text**: Text used for the privacy policy link (e.g. “Privacy Policy”). Visible when the consent checkbox is on. * **Success heading text**: Heading shown after a successful signup (e.g. “Welcome!”). * **Success message**: Message shown after a successful signup. You can thank them and mention what to expect next. * **Show discount code**: When enabled, a discount code can be shown after signup to encourage a first purchase. * **Discount label**: Short text above the code (e.g. “Here’s your exclusive discount:”). Visible when Show discount code is on. * **Discount code**: The code to display (e.g. WELCOME10). Create the code in Shopify Admin and enter it here. Visible when Show discount code is on. * **Show action buttons**: When enabled, shows one or two buttons after signup (e.g. “Shop Now”, “View Collections”). * **Primary button text** / **Primary button URL**: Label and link for the first action button. Visible when Show action buttons is on. * **Secondary button text** / **Secondary button URL**: Label and link for the second action button. Visible when Show action buttons is on. #### Buttons group * **Label**: Text on the button (e.g. “Shop the sale”). Leave blank to hide the button. * **Link**: Page or URL the button goes to. * **Button style**: Appearance of the button: **Solid button**, **Outline button**, or **Transparent button**. #### Countdown Timer * **End date**: Date when the countdown ends (format: YYYY-MM-DD). * **End time**: Time of day when it ends (format: HH:MM:SS, 24-hour). * **Text to show when countdown ends**: Message or rich text displayed when the countdown reaches zero (e.g. “Event has ended!”). * **Number size**: Size of the countdown numbers. * **Label size**: Size of the labels (e.g. “Days”, “Hours”). * **Container**: When enabled, places the countdown inside a container for clearer separation from the rest of the content. * **Color scheme**: Color scheme for the countdown block (if the theme supports it). *** ### Presets * **Popup**: Default layout with Heading, Text, and Email form; ideal for newsletter signup. * **Popup with button**: Same as above but uses a Buttons group block instead of the email form; useful for driving visitors to a page or promotion. *** ### Tips * Use **Test mode** while building the popup so you can see all blocks and styling without waiting for triggers. Remember to turn it off when you’re done. * **Exit intent** works best on desktop; on mobile, **Delay** or **Scroll percentage** are more reliable. * **Once per session** keeps the popup from showing again until the visitor closes the browser or the session ends, which helps avoid feeling repetitive. * If you show a discount code, create the discount in **Shopify Admin > Discounts** and use the same code in the Email form block so it’s valid at checkout.