Set Up The Pop-ups App

The Pop-ups app can serve multiple purposes. It can grab your visitors' attention, increase visitor retention when they try to leave your page, or offer incentives through discounts. It can even be used as a promotion tool for specific products or as a newsletter subscriptions email capture system!

The Pop-ups app is a versatile tool, which can definitely boost your store's conversions with a bit of careful planning and marketing strategies, so make sure to leverage the most of the app by setting everything up correctly.

Priority is checked first, before each pop-up's own settings. A pop-up set to appear instantly still waits behind a higher-priority one, and its display delay only decides when the winning pop-up appears, not which one wins. You choose the order yourself — see Choosing which pop-up shows first below.

Once a visitor has seen every pop-up that is currently eligible for them, the cycle starts again from the top of your list. The record of what they have already seen also resets after a day, so a visitor returning tomorrow starts again from your highest-priority pop-up.

The Pop-up app is found under your Apps list, inside the Marketing category:

Here's how to set up pop-ups in your store.

1. Creating a new Pop-up

You start by creating a new pop-up by clicking the Create pop-up button:

2. Choose a Pop-up type.

When creating a new Pop-up, you can choose between 3 Pop-up types:

1. Signup
   • Ask visitors for their contact details.
2. Signup with discount
   • Offer a discount code.
3. Make an announcement
   • Share news, new arrivals, or a sale.

Above the cards is a row of tabs that filter by goal — All, Grow my list, Discount, Announcement and Guide visitors to a page — and a Color theme picker in the top-right corner that sets the starting colours for the pop-up you are about to create. You can always change the theme later in the Style card.

Once you are ready with your choice, simply click the Set up pop-up button to start customizing it.

3. Customize your Pop-up.

Regardless of the Pop-up type you chose, the following settings can be customized. They are divided into sections: Settings, Pop-up form fields, Main pop-up content, Success pop-up content, Position, Media, and Style.

• Publish pop-up - choose whether the pop-up goes live Immediately or on a Schedule. If you schedule it, set a Start date, Start time and Timezone, and optionally tick Set end date so it stops on its own. Leave the end date unchecked to keep it running until you turn it off. This is how seasonal and BFCM campaigns are usually set up.
• Internal name - Since you can create multiple Pop-ups, you can easily distinguish between them by giving each one an internal name. It is only visible in your Vitals dashboard — visitors never see it — and it is also what the editor shows as the page heading, so a clear name makes a long list much easier to work with.
• Trigger Types - which allows you to choose how the Pop-up would appear on your store:
• On page load with delay - Pop-up will automatically appear after X seconds, that you can define. The delay decides when the pop-up appears, not whether it beats another pop-up — priority is always checked first.
• On exit intent - Pop-up will only be displayed if the visitor intends to leave the store (by moving the mouse pointer outside the browser or quickly scrolling upward on the store on a mobile device)
• On scroll down - Pop-up appears once the visitor has scrolled far enough down the page. Choosing it reveals an At least slider, where you set how far down that is (10% to 100%, in steps of 5).
• Show on - lets you choose on which device will the Pop-up only appear on (Any Device, only mobile phone, or only desktop and tablet)
• Show pop-ups every X page views - If the pop-up already appeared for the visitor, you can place here the number of pages that the visitor can visit on your store before they can see this pop-up again. This count is per pop-up, and it only moves forward on page views where this pop-up was the one in line to be shown. If a different pop-up is ahead of it in your priority order, this pop-up's counter simply waits — so each pop-up keeps its own pacing instead of all of them running down the same clock together.
• If closed, display again after waiting for - when a visitor actively turns your pop-up down, this is how long it waits before it can appear for them again. You can set it in hours, days or weeks, and the default is 24 hours. "Actively turns it down" means the visitor used the pop-up's own close (X) button, or its No, thank you button. Other ways of closing do not start this waiting period: if a visitor clicks your main button, or clicks the shaded backdrop around the pop-up, the pop-up simply carries on with its normal trigger and frequency settings. This way, the longer waiting period is reserved for visitors who genuinely said no.
• Display on cart page - Some stores do not want to show the Pop-up on the cart page, as that is one of the last steps before an order is completed. Should you like to have it still appear there, you can enable this option. Note that this applies to On exit intent pop-ups only — pop-ups using On page load with delay or On scroll down never display on the cart page, whatever this option is set to.
• Enable bot filter (CAPTCHA) - enables the Pop-up to have a bot filter when visitors enter an email address (for extra security)
• Overlay - the shaded backdrop behind your pop-up. Choose Show to require visitors to interact with the pop-up before they carry on browsing, or Hide to let them keep clicking around your store while the pop-up stays on screen. The default is Show, so pop-ups you already created keep behaving exactly as they did.
• Close popup when clicked - available when the overlay is set to Show. Leave it on (the default) and clicking anywhere on the backdrop closes the pop-up. Turn it off if you would rather visitors close it with the pop-up's own close button. Either way, pressing Esc always closes a pop-up.
• Clicking the backdrop counts as dismissing the pop-up for that page view only — it does not start the If closed, display again after waiting for countdown. Only the pop-up's own close (X) button and its No, thank you button do that.

Consent card - shown on signup pop-ups, this is where you handle the consent checkboxes that appear under the form.

• Show consent checkboxes for all countries - When enabled, the Consent checkbox will be shown for all visitors regardless of where they are visiting from.
• Request consent from European customers - EU customers have to accept your Privacy Policy before providing their personal data.
• Text - The custom text of your consent checkboxes
• Privacy Policy URL - The URL on your store that points to your store's Privacy Policy
• Collect marketing consent - EU customers have to accept marketing consent to join your email or SMS marketing list.

Content Screens card

This card holds the wording of the pop-up itself, split across screens. A preview switcher above it lets you flip between Screen #1 and Screen #2 as you edit. (An Add new screen button is visible but not available yet — it is badged Soon.)

Screen #1 - the pop-up your visitor first sees. This is where you define and customize its content, like:

• Heading
• Body
• Contact fields - Email Address, Phone Number, or both Email Address and Phone Number
• Button text

Screen #1 also has an Add field button, which lets you add:

• Countdown timer - a live countdown inside the pop-up. It is only available once your pop-up has an end date, so switch on Set end date under Publish pop-up first. Adding it gives you a Countdown title field, where the Insert timer action drops the timer into your wording.
• Dismiss button - the secondary "No, thank you" link that lets a visitor turn the offer down.

Screen #2 - the success screen.

• If the pop-up type you chose is either Signup or Signup with discount, you can define the custom text that will appear in the success pop-up.
• If you have chosen Signup with discount, this is also the area where you can place the discount code that you will provide to your customers, after they signed up on Screen #1.

• In addition, Shopify discount codes can now be combined with automatic Vitals discount codes on order, using Shopify's Discount Combinations feature. More information about this and its requirements can be found here: Combine Shopify Discounts with Vitals Discounts in an Order

Position section

This is where you choose where the pop-up sits on the screen. Desktop and mobile are set separately, so a pop-up can sit in a discreet corner on desktop and along the bottom of the screen on a phone.

• Desktop - pick any of nine spots on a three-by-three grid: top, middle, or bottom, combined with left, center, or right. Whichever you pick, the pop-up keeps a small margin from the edge of the screen so it never sits flush against the browser window.
• Mobile - pick top, middle, or bottom. There is no left or right choice here, because pop-ups always span the full width of the screen on mobile.

You can click a spot on the grid or move around it with your arrow keys. The defaults match how pop-ups have always displayed - centered on desktop, along the bottom on mobile - so pop-ups you already created will not move unless you change them.

Media section

This is where you can upload a background or side image and optionally a logo for your Pop-ups:

Style card

This last card allows you to customize the appearance of the Pop-up app even further:

• Close button style - Round, Square or Plain, for the X icon in the corner of your pop-up
• Content alignment, Heading text size and Paragraph text size
• Button style - Filled or Outline - and Corner radius
• Color theme
• Background and text color via color pickers (if the available color themes are not sufficient)
• Button colors
• Close button colors - Background, Hover and Text
• Overlay - the color of the shaded backdrop behind your pop-up (only shown when the overlay is set to Show)
• If you added a countdown timer, Style also gains Countdown alignment, Countdown text size and the countdown's Background and Text colors

Save the Pop-up

Once you are done with your customizations, use the buttons at the top of the page: Publish puts the pop-up live on your store (or queues it, if you set a schedule), and Save as draft keeps your work without displaying it to visitors yet.

Choosing which pop-up shows first

Only one pop-up is shown per page view. When several are eligible at the same moment, the one with the highest priority wins, and the next one appears the next time the visitor loads a page. You decide that order from the pop-ups list:

1. Open the Pop-ups app to see your list of pop-ups.
2. Select Change priority in the toolbar. The list turns into a drag-and-drop view with the instruction Drag the rows to set which pop-up is shown first.
3. Drag the rows so the pop-up you want shown first sits at the top.
4. Save. You will see a Sorting order saved confirmation.

A few things worth knowing:

• The order runs top to bottom — think of it as a position in the list rather than a number, since you never have to type one.
• Change priority appears only when you have more than one pop-up (drafts included) and the list is on its default sort.
• Reordering always works on the full list. Search and the status tabs step aside while you are dragging, so a filtered view will not limit what you are reordering.
• A new pop-up, and a duplicate of an existing one, goes to the top of the list. A duplicate does not keep the priority of the pop-up it was copied from.
• Nothing changes on your store until you reorder. Every pop-up that existed before this arrived starts on the same priority, and pop-ups on the same priority keep the order they had before.
• Priority is checked first, and each pop-up's own settings — the display delay, exit intent, scroll depth — are checked afterwards. A pop-up set to show instantly still waits behind a higher-priority one.
• Once a visitor has seen every pop-up that is currently eligible for them, the cycle starts again from the top of your list. The record of what they have already seen also resets after a day, so a visitor returning tomorrow starts again from your highest-priority pop-up.

Finding your way around the pop-ups list

Alongside Change priority, the list page gives you:

• Search pop-ups - filter the list by name
• Sort by - Priority (highest first) (the default), Name (A–Z) or Created date (newest first)
• a column chooser, so you can decide which columns the table shows

Pop-up statuses

Each pop-up carries a status badge next to its name and on its row in the list:

• Active - published, and currently displaying on your store
• Draft - saved, but not published
• Scheduled - published with a start date that has not arrived yet
• Expired - published with an end date that has already passed

The filter tabs above the list group these a little more broadly: All, Active, Inactive and Scheduled, where Inactive covers both Draft and Expired pop-ups.

Deactivating a Pop-up

If you would like to temporarily deactivate a Pop-up and use it later, you can select the desired Pop-up in the list through its checkbox and select the Hide option in the menu (3-dots) that appears:

Deleting a Pop-up

To permanently delete a Pop-up, simply select the desired Pop-up to be deleted on the list through its checkbox, and then select Delete in the menu (3 dots) that appears:

Translating the Pop-up

• There are two ways that you can utilize to translate the contents of the Pop-up app:

  • Specific Pop-up translations - Should you like to translate only the content of the specific pop-up you're working on, you can click on the Translate button at the upper-right corner while inside that specific Pop-up app's settings:

    

    
    

  • Global Pop-up Translations - Should you like to translate overall, global texts of the Pop-up app, you can click the Translate button while in the main Pop-up app:

    

Tracking how your pop-ups perform

The Pop-ups app has an Analytics tab showing Impressions, Clicks, Closes and Captured emails. It defaults to the last 30 days and compares that against the previous period, so you can see whether a change you made helped.

These figures cover all of your pop-ups together rather than one at a time. Per-pop-up reporting is marked Soon in the app and is not available yet, so if you want to measure one specific pop-up, run it on its own for a period.

Frequently Asked Questions (FAQs)

Does your Pop-up app have animations?

Our Pop-up app does not have integrated animations at the moment. However, we already have this on our suggestions list, and we'll definitely post an update on our Product Roadmap when we have updates about this feature.

Why don't my pop-ups show in the Shopify theme editor?

Pop-ups are deliberately suppressed inside the theme editor preview, so you will never see them while customizing your theme. This is intentional - it stops them from covering the editor while you work. To check a pop-up, visit your live storefront in a private or incognito window instead, which also gives you a clean visitor session so the trigger and frequency rules behave normally.

Can the Pop-up app detect if an email address was already entered?

No, the Pop-up app cannot detect if an email address has already been entered. Here's why:

1. Direct Integration with Shopify Customers
   • When an email address is captured through the app, it is immediately sent to your Shopify admin > Customers section with the tag "VITALS"  .
   • The Vitals app does not store email addresses independently.
2. Adherence to Shopify Policies
   • To comply with Shopify's strict data privacy policies, the app does not maintain its own database of email addresses.
   • This means there’s no mechanism to check if a newly entered email matches one that was previously captured.

My pop-up's background shading looks lighter than it used to. Why?

The shading behind a pop-up is now a setting you control rather than a fixed value, and the new default is a lighter, softer shade than the one pop-ups used before. If you would prefer the darker look, open the Style card and set the Overlay color to a darker shade (or raise its opacity).

I set a pop-up to show instantly and a different one appeared first. Why?

Priority is checked before the display delay, so a higher-priority pop-up takes the page view even if it is set to appear later. Move the pop-up you want shown first to the top of the list with Change priority.

Why do I only ever see the same pop-up?

The highest-priority pop-up shows first, and the rest follow on later page views once the visitor has seen it. If the visitor's browser is blocking cookies, your store cannot remember what they have already seen, so every page view starts again from your top pop-up.