Skip to main content
Popups show a message to the people who browse your Shopify store. A popup can collect WhatsApp numbers and emails, show a discount code, or announce a sale. Popups are in Growth Tool Kit → Popups, at ai.textyess.com/growth-tool-kit/popups. They are for Shopify stores.

Create a popup

  1. Open Growth Tool Kit. On the Popups card, click Create a popup.
  2. Click New popup.
  3. Choose a starting point: Collect contacts, Share news or Start from scratch.
  4. In the Design tab, edit the blocks, the texts and the style.
  5. Click Preview to try the popup. The preview saves nothing.
  6. Click Save.
A new popup is a Draft. It shows on your store only after you click Publish and turn on the TextYess app embed in your theme. The popup editor needs a wide window. On a small screen, make the window wider or close the side panels.

Collect WhatsApp numbers and emails with a popup

In the popup editor, open the Design tab. Add fields from the Form blocks:
  • Email field collects an email address.
  • WhatsApp field collects a WhatsApp number, with a country code.
  • Field collects another contact attribute, for example First name or Birthday. To make a new attribute, click Add new attribute in the attribute list of the field.
A popup can have one Email field and one WhatsApp field. A visitor must give an email, a WhatsApp number, or both. To ask for the details in more than one step, click Add step. A step where all fields are optional shows Skippable. Each Email field and WhatsApp field of a popup shows a consent notice. You can edit the notice in the field settings, or show it as a Checkbox that the visitor must tick. Every subscription stores the exact consent text and its version, the channel, the page URL, the visitor language, the IP address and the browser details. You can hide the notice. If you hide it, you must inform your subscribers in another way.

Show a discount code after a popup sign-up

Add a Discount code block to the Success screen of the popup. Visitors copy the code with one click. In the block settings, choose the Type:
  • Fixed: every visitor sees the same code. Create the code in Shopify first, then type it in Code.
  • Unique: each visitor gets their own code. In Discount, pick a discount from Growth Tool Kit → Unique discount codes.
With Unique, a visitor who submits again sees the same code while it is valid. A visitor who already used the code in an order gets no new code. A welcome automation that sends a code from the same discount sends this code. You can publish the popup only when its discount is active. See Unique discount codes.

Announce a sale with a popup that collects nothing

A popup does not have to collect contacts. When you create the popup, choose Share news. Or delete all the Email and WhatsApp fields of an existing popup.
  1. Click the popup button.
  2. In Destination, type the page to open, for example /collections/sale. The page opens in the same tab and the popup closes.
  3. To show no button, set Show button to Off.
A popup that collects nothing has no success screen and no Lists & Sync tab. In the Popups list, its Submits and Opt-in rate show a dash.

Turn on double opt-in for a popup

With double opt-in, a sign-up becomes a subscriber only after the visitor clicks the link in a confirmation email.
  1. Open the popup and go to the Lists & Sync tab.
  2. Turn on Require confirmation by email. The popup must have an Email field.
  3. Click Preview to see the confirmation email, or Edit email to change it. You cannot remove its confirm button.
  4. Save the popup.
Each confirmation email uses one email credit, and its link stays valid for 7 days. Until the click, the sign-up shows as pending at the top of All Contacts, with a Resend button. If email sending is not set up, or your email credits are empty, the popup adds the sign-up without confirmation. More details: Email popup installation.

Choose the pages where a popup shows

In the popup editor, open the Behavior tab. In When to show, find Pages. With no rule, the popup shows on every page. Click Add URL rule to add a rule. Each rule has three parts:
  • Show on or Hide on.
  • Which pages:
    • URLs containing: type part of the page path, for example /collections/.
    • This exact URL: type one page, for example /pages/contact. Upper and lower case, a / at the end, and the part after ? don’t matter.
    • The homepage: the main address of your store, /, in every language (for example /fr too).
  • The URL, for the first two. You can paste a whole link: only the path is kept.
You can add up to 20 rules:
  • With one or more Show on rules, the popup shows only on pages that match at least one of them.
  • With only Hide on rules, the popup shows on every page except the ones you hide. For example, hide it on /policies/ and /pages/contact.
  • A page that matches a Hide on rule never shows the popup, even if it also matches a Show on rule.
Rules also match pages in other languages: a rule for /collections/sale matches /fr/collections/sale.

Show a popup only in some countries or languages

In the popup editor, open the Behavior tab and find Who sees it.
  • For Country, choose Only visitors in these countries or Everyone except visitors in these countries. Then pick the countries.
  • For Language, choose the same kind of option and pick the languages.
If you set both, a visitor must match both. The country comes from the visitor’s location, as Shopify detects it. If Shopify cannot read the country, the popup stays hidden for that visitor. The language is the language of the store page. See Localize your popup.

Show a popup only on mobile or only on desktop

In the popup editor, open the Behavior tab and find Who sees it. For Device, choose Mobile only or Desktop only. Mobile and desktop shows the popup on every screen. Mobile means a screen up to 640 pixels wide, like a phone. Tablets and computers count as desktop. Use this to give an offer, for example a discount code, only to the people who got your email.
  1. In the popup editor, open the Behavior tab and find Who sees it.
  2. For Link, choose Only visitors who arrive through a link.
  3. Type the end of the link. Use one of these forms:
    • An anchor, for example #vip10.
    • A link parameter with its value, for example utm_campaign=vip10.
    • A link parameter with any value, for example utm_campaign.
  4. Save the popup and set it live.
  5. In your email, add the same text at the end of a link to your store, for example https://yourstore.com/collections/sale?utm_campaign=vip10.
The link can open any page of your store. The popup then shows on each page that the visitor opens, until they close the browser tab. Other visitors do not see it. The text must match exactly, but upper and lower case do not matter. #vip1 does not match a link that ends with #vip10. Other parameters on the link, for example the UTM tags that an email tool adds, do not stop the match. To match more than one parameter, join them with &, for example utm_campaign=vip10&utm_source=email. The Pages setting still applies. Keep All pages to show the popup on every page of the visit.

Hide a popup from customers who already subscribed

In the popup editor, open the Behavior tab. In Who sees it, turn on Hide from logged-in customers who already subscribed. The switch shows on a popup with an Email field or a WhatsApp field. The popup and its teaser stay hidden for a customer who is logged in to your store and subscribed to every channel that the popup asks for. TextYess then tries your next live popup. Visitors who are not logged in see the popup as before. If your store uses legacy customer accounts, the switch works only when Shopify verified the email of the customer. If the card shows Approve in Shopify, click it and approve the new permission in Shopify. See Email popup installation.

Show a popup only to customers in a list or segment

Use this to show a popup only to your VIP customers, or to everyone except them. It works on Shopify stores.
  1. In the popup editor, open the Behavior tab and find Who sees it.
  2. In Lists and segments, choose Only customers in these lists or segments or Everyone except customers in these lists or segments.
  3. Choose up to 10 lists or segments.
TextYess knows the lists of a customer who is logged in to your store. It also knows them for a visitor who is not logged in, when TextYess already knows the visitor’s browser: the visitor came to your store from a link in a TextYess email or WhatsApp message, checked out, or signed up on that browser. The browser counts only when the visitor accepted tracking on your store. Any other visitor counts as in no list: an Only popup stays hidden for that visitor, and an Everyone except popup shows. A segment counts its members as of its last refresh. When you delete or archive a list, it no longer counts in the rule. If the card shows Approve in Shopify, click it and approve the new permission in Shopify.

Set when the popup opens, its format and teaser

In the popup editor, open the Behavior tab:
  • How it appears: choose a Popup in the center, a Flyout in a corner, or a Banner on the top or bottom edge.
  • Show the popup: choose when the popup opens.
    • After a delay: in Delay before showing (seconds), type the wait after the page opens. A new popup waits 3 seconds.
    • After the visitor scrolls part of the page: in Part of the page scrolled (%), type a number from 10 to 100. With 50, the popup opens when the visitor scrolls past half of the page. The count starts again from the top on each page load. On a page that does not scroll, the popup opens at once.
    • When the visitor is about to leave: on a computer, the popup opens when the pointer leaves the top of the page, toward the tabs or the address bar. It opens once on each page. Phones and tablets have no pointer, so there the popup opens after the wait in Delay on phones and tablets (seconds).
  • Days before showing again: a visitor who closes the popup does not see it again for this number of days. A new popup uses 7 days.
  • Collapse into a teaser when closed: the closed popup becomes a small tab on the screen edge. A click on the tab opens the popup again.
A visitor who subscribes does not see the popup again in the same browser. A popup that starts as a tab shows the tab at once, with either option.

Show a countdown in a popup

Add a Countdown block to a step or to the Success screen. In the block settings, pick the date and time in Ends on. The date uses the time zone of your store, and Europe/Rome when your store has none. The settings show the time zone below the date. The block shows the days, hours, minutes and seconds left, and counts down every second. The labels follow the language of the popup text: English, Italian, French, Spanish or German, and English for other languages. The time left comes from the clock of the visitor’s device. At the end date, the block hides and the rest of the step stays. A block with no end date, or with an end date in the past, does not show on your store. The editor shows a warning on it.

Change the design of a popup

In the popup editor, open the Design tab. The sidebar has two tabs: blocks and styles.
  • In blocks, add a heading, text, an image, a countdown, fields, or a header image.
  • In styles, set the Theme: the Palette and the Font.
  • To change one block, click it on the popup. Its text and style settings open in the sidebar.
A header image that you drop on the popup must be under 5 MB.

Translate a popup into the languages of your store

One popup works for all the languages of your store. A visitor sees the popup in the language of the store page. TextYess translates the texts automatically, into a maximum of 12 languages for each popup. TextYess never translates the consent notice. Write it for each language in the Languages tab of the popup editor. In the same tab, you can edit any translation or turn off a language. See Localize your popup.

Where popup subscribers go

When a visitor submits a popup, TextYess:
  • Creates or updates the contact. A WhatsApp number gets WhatsApp marketing consent. An email gets email marketing consent.
  • Adds the contact to the list in Lists & Sync → TextYess list. The default list is Contacts from form submission.
  • Saves the other details, for example the first name, on the contact.
  • Starts the automations with the Contact Entered List trigger for that list, also when the contact was already on the list. This works for lists made in TextYess or imported from a CSV file.
  • Adds the contact to your Klaviyo list, or writes the marketing consent to the matching Shopify customer, if you turned this on in Lists & Sync.

Install a popup on your Shopify store

A popup shows on your store only when its status is Live and the TextYess app embed is on in your theme.
  1. In the popup editor, open the Install tab.
  2. Click Open Shopify Theme Editor.
  3. In App embeds, turn on TextYess. Then click Save.
You do this only once. The same app embed shows all your live popups, and also the onsite AI chat if you use it. See Email popup installation.

Put a sign-up form inside a page, or on its own sign-up page

A form can also sit inside a page of your website instead of opening over it. In the popup editor, open the Behavior tab and, in Where it shows, choose Inside a page. The form uses the same blocks, consent notice, list and discount code as a popup. It never opens by itself, so the delay, pages, audience, teaser and Days before showing again settings do not apply. The dates in the schedule still apply. When the form is Live, open the Install tab. You have three ways to show it:
  • Sign-up page: the form on a page of its own, with a link and a QR code. On a Shopify store the link uses your own domain, for example yourstore.com/apps/textyess/signup/.... Click Download QR code to print it for your shop, a flyer or a social bio. After each sign-up, the page shows Sign up someone else, so your staff can sign up one customer after another at the till.
  • Add it to your Shopify store: copy the Form ID, click Add the block to your theme, paste the ID in the settings of the TextYess Sign-up form block, then click Save. You can move the block to any page and any section.
  • Add it to any website: copy the code and paste it where the form should appear.
Contacts who sign up get the same consent and go to the same list as a popup sign-up. To find them later, choose a list for the form in Lists & Sync, for example a “Shop” list, and use it in a segment.

Publish, pause, archive or delete a popup

  • To show the popup on your store, click Publish in the top bar of the popup editor. The status becomes Live.
  • To hide a live popup, click Pause. You can also pause it from the … menu in the Popups list.
  • You can archive or delete a popup only when it is not live. Pause it first.
  • An archived popup moves to the Archived tab. Restore brings it back as a Draft.
  • Duplicate makes a draft copy. The copy name ends with “(Copy)”.
When you delete a popup, the contacts it collected stay in your lists.

See popup results

The Popups list shows these columns for each popup:
  • Views: the number of times the popup opened for a visitor.
  • Submits: the number of sign-ups.
  • Confirmed: the number of confirmed emails, when double opt-in is on.
  • Opt-in rate: submits divided by views.
  • List: the TextYess list that gets the subscribers.
A popup that collects nothing shows a dash in Submits and Opt-in rate.

Which popup shows when several popups are live

A visitor sees one popup at most on each page. When several popups are live, TextYess first checks the popups for the email link that the visitor clicked. Then it checks the popups for a list or segment, then the scheduled popups, then the others. In each group, it starts from the most recently changed. It shows the first popup that matches the page and the visitor’s country and language. TextYess skips a popup that the visitor submitted. It also skips a popup that the visitor closed, for the number of days in Days before showing again. It also skips a popup that hides from subscribed customers when the logged-in visitor already subscribed.

Why a popup does not show on your store

Make sure that:
  • The popup status is Live.
  • The TextYess app embed is on in your Shopify theme, and you clicked Save.
  • The page matches Pages, and the visitor matches Who sees it.
  • If the popup is for an email link, you opened the store through a link that ends with the text in Link.
  • The delay in Delay before showing (seconds) has passed, the visitor scrolled the part of the page in Part of the page scrolled (%), or, for When the visitor is about to leave, you moved the pointer out of the top of the page.
  • Your screen matches Device. To test a Mobile only popup on a computer, make the browser window narrower than 640 pixels.
  • You did not close or submit the popup before in this browser. To do a test, use a private browser window.
  • You are not logged in as a customer who already subscribed, if the popup hides from subscribed customers.
  • If the popup is for a list or segment, you are logged in as a customer who matches the rule, or you opened the store from a TextYess link sent to such a customer.
  • No other live popup shows first on that page.