--- title: Configuring the popup url: https://support.troopthemes.com/guide/beyond/configuring-the-popup/ theme: Beyond theme_styles: Fleur --- # Configuring the popup in Beyond The popup lives in **Edit theme** → **Popups**, an overlay section that appears across the whole store. It is not the announcement bar (that's on the **Header** section), not checkout, and it does not send email campaigns by itself: Shopify Inbox, discount codes, and email delivery are all separate. ![Beyond Popups block list and Newsletter (small) settings](https://support.troopthemes.com/_images/beyond/popup--settings.jpg) > **Compatibility** > > Image (and left/right or top placement) options on the **Newsletter (small)** and **Newsletter (large)** popup blocks require version 7.2.0 and up. Video media requires 7.3.0 and up. ## Popups section (Beyond) **Edit theme** → **Popups**. By default it already has a **Newsletter (small)**, **Promotion bar**, and **Cookie consent** block. Click a block's eye icon to show or hide it, or **Add block** for another type: - **Newsletter (small)** – corner overlay with an email field. - **Newsletter (large)** – centered overlay modal. - **Promotion bar** – sticky bar with a message; can scroll like a ticker (**Scroll text**, with separate speed controls for desktop and mobile). - **Cookie consent** – consent banner tied to Shopify's consent tracking API. Heading and description live on each block, not in Theme settings. ### Newsletter (small) (Beyond) Corner overlay with an email field. - **Media type**, **Image**, **Video upload**, **Video link**: shown when **Show media** is on; video accepts a Shopify upload or a YouTube/Vimeo link. - **Heading**, **Description**: the popup's copy. - **Show social icons**, **Social media title**: adds your [social icons](https://support.troopthemes.com/guide/beyond/social-media/) below the form. - **Background color**, **Translucent background**: card styling. - **Popup width**: maximum width on larger screens (300–500px). - **Show media**, **Media position** (**Left** or **Top**): whether an image or video shows, and where. Media is hidden on mobile to meet Google's guidelines against intrusive interstitials. - **Heading type**, **Paragraph font size**, **Text color**, **Text alignment**: text styling. - The submit button always shows as an arrow icon here; there's no button text or style setting to configure. - Timing and targeting settings (**Popup delay**, **Show again after**, and so on) are shared with **Promotion bar**. See **Timing and frequency** below. ### Newsletter (large) (Beyond) Centered overlay modal, with the same settings as **Newsletter (small)** above, except: - **Popup width** ranges wider (500–900px), since it's a centered modal rather than a corner card. - **Media position** is **Left** or **Right** instead of Left/Top. ### Promotion bar (Beyond) Sticky bar with a message. - **Description**: the bar's message text. - **Background color**, **Translucent background**. - **Scroll text**, **Scroll speed**: ticker effect on desktop, plus a separate **Scroll text**/**Scroll speed** pair under **Mobile** so the ticker can run independently (or not at all) per device. - **Heading type**: **Medium** or **Small** text size. - **Text color**. - Timing and targeting settings are shared with the **Newsletter** blocks. See **Timing and frequency** below. ### Cookie consent (Beyond) Consent banner tied to Shopify's consent tracking API. See **When cookie consent shows** below for the conditions. - **Heading**, **Description**. - **Background color**, **Translucent background**. - **Position**: **Left**, **Bottom**, or **Right**. - **Text color**, **Text alignment**. - **Accept button style**, **Decline button style**: each independently set to one of your four button styles, or a plain text **Link**. ## Timing and frequency (Beyond) **Newsletter** and **Promotion bar** blocks each have: - **Popup delay** – seconds before it opens. - **Show popup at bottom of page** – opens early if the visitor scrolls to the bottom first. - **Show again after** – days before it reappears once dismissed. This is stored in the visitor's browser, not in Shopify, so it's per browser/device, not per customer. - **Limit to specific referrer path** / **Limit to specific page** – restrict where it can appear. The section's own **Limit to one popup per page load** setting controls whether only the first ready popup shows, or they queue one after another. **Cookie consent always takes priority** when it needs to appear. ## When cookie consent shows (Beyond) Cookie consent only shows where Shopify's consent tracking API determines a banner is required, and only if the visitor doesn't already have a stored choice. It won't show for everyone. Customer privacy tracking limits must also be turned on in your Shopify admin (**Settings** → **Customer privacy**), or it won't show at all. Position and the **Accept**/**Decline** button styles are configurable; it doesn't use the delay/frequency settings above. ## Previewing changes (Beyond) **Newsletter** and **Promotion bar** popups do **not** open automatically while you're editing. That's expected, not a bug. Preview them from the storefront (or **Preview**), ideally in a private/incognito window, since **Show again after** is remembered by that browser and will suppress a popup you've already dismissed while testing. **Cookie consent** is the exception: click it in the block list to preview it live in the editor. --- Where newsletter forms live (section, overlay, popup, footer, password page): [Setting up mailing lists and newsletters](https://support.troopthemes.com/guide/beyond/newsletters/). ## Troubleshooting (Beyond) - **Popup never appears**: the block is hidden (eye icon); **Show again after** already fired for that browser (test in a private window); another popup is already showing and **Limit to one popup per page load** is on; or a separate app popup is competing. Turn off other popup app embeds. - **Cookie consent doesn't show**: Customer privacy tracking isn't enabled in your Shopify admin, or the visitor's region/consent state doesn't require a banner. - **It won't preview in the editor**: expected for **Newsletter** and **Promotion bar** blocks. Preview from the storefront instead. - **Announcement bar isn't here**: that's on the **Header** section, not **Popups**. - **Form emails don't reach Mailchimp/Klaviyo**: the popup only creates a Shopify customer (tagged `newsletter`). See [newsletters](https://support.troopthemes.com/guide/beyond/newsletters/), or connect an [app](https://support.troopthemes.com/guide/using-apps-with-themes/).