Marketing Studio

How to create a popup for your site (Popups)

How to create a popup for your site (Popups)

TeleportHQ Popups show a one-time offer on your published site by themselves: a newsletter signup, a discount code, a link to something you sell, or an announcement. In the editor, open Growth → Marketing Studio → Popups, click New popup, choose what the popup is for, pick a layout and a ready design (or let AI write it), and click Create popup. Then publish your site. By default, the popup opens when the pointer leaves the page on a computer and after 20 seconds on a phone, at most once every 7 days, on every page.

A TeleportHQ popup opens by its own rules. To open a pop-up when a visitor clicks a button you choose, use the Modals element instead: see How to add a pop-up (modal).

Before you start

  • A Trial, Pro or Premium workspace. When the trial or subscription has ended, the Marketing Studio shows "The Marketing Studio is a paid feature", and New popup opens an upgrade window.
  • Editing rights. In a project you can only view, TeleportHQ says "This project is read-only — Growth actions are disabled."
  • No web app and no sign-in needed. Popups work on websites, stores and web apps alike.
  • Some popups need a feature first. A newsletter popup needs the Newsletter switched on (How to turn on the Newsletter and collect subscribers). A discount popup needs your store with its checkout page. A popup that promotes something needs a page, a product or a bookable item to point to.
  • AI tokens only if AI writes the popup: TeleportHQ holds back 300 AI tokens for each Generate. A ready design costs no AI tokens.

Open Popups in the Marketing Studio

  1. In the editor's left sidebar, click Growth. If a Welcome to Growth! window appears, click Maybe Later.
  2. In the Growth panel, click Marketing Studio.
  3. In the studio menu, click Popups ("One-time offers, by rules").

The TeleportHQ Popups section opens with the heading "Popups — one-time offers your site shows by itself" and a New popup button. Before your first popup, it shows "No popup yet — start from one of these" with three cards: Grow the newsletter, Welcome discount and Announcement. A card you can't use yet is greyed out, with the reason under it.

The Popups section of the TeleportHQ Marketing Studio before the first popup, with its three starter cards and the New popup button highlighted

If you switched on the Newsletter, a popup named Newsletter may already be listed: it's the Newsletter's own signup popup, made when you switched it on.

Create a popup

1. Choose what the popup is for

  1. In Popups, click New popup at the top right, or click one of the starter cards. The New popup window opens on its first step, What it is for.
  2. Under "What is the popup for?", click a card:

    CardWhat the popup doesWhat visitors get
    Grow the newsletterAsks visitors for their emailAn email field and a Subscribe button. Signups become your newsletter subscribers.
    Welcome discountGives a discount code to use at checkout"Your code", the code, and a Copy code button
    Promote somethingPoints visitors to a product, a page or an offerA button: Shop now for a product, Book now for a bookable item, Learn more for a page
    AnnouncementShares news, a holiday closing or a changeAn optional button to a page or to something you sell
    Something elseAnything you likeAn optional button to a page or to something you sell

    Every popup also has a ✕ and a quiet button that closes it: No thanks, Not now, Got it or Close, depending on the card.

  3. Fill in what the card asks for:
    • Welcome discount: under The code it hands out, pick one of your store's active codes, or choose Create a new code… and type the Percent off (a whole number from 1 to 90). The window shows the code it will make, for example "A new voucher, SAVE10, 10% off the first order, is made when you create the popup. You find it in Vouchers."
    • Promote something: under What it promotes, click Something you sell and click a product or bookable item (use the search box to find it), or click A page and choose it under Pick a page.
    • Announcement or Something else: under Button (optional), keep No button, or choose Something you sell or A page.
    • Grow the newsletter: nothing to fill in. The window says "Signups are saved to your contacts, ready for your emails and campaigns."
  4. Click Next.

    The Design step of the TeleportHQ New popup window, with the layouts, the Write it with AI and Start from a design choices and the Create popup button highlighted, and a preview of the popup on the right

2. Design the popup

  1. Under Layout, click Center (over the page, which waits), Corner (a card in the corner) or Bottom bar (along the bottom edge). You can't change the layout later.
  2. In Name, type a short, plain name, for example Welcome discount. Screen readers read it out as the popup's name.
  3. Choose how to make the content:
    • Start from a design (chosen at first): under Designs, click one of the three designs, such as Classic. You change its words later in the builder. No AI tokens are used.
    • Write it with AI: under What should it say?, describe the popup, for example 10% off the first order for new visitors, ends Sunday. Click Generate. The AI writes the text and the look around the working part (the form, the code or the button), in your site's main language. To try again, change the text and click Generate again.
  4. Check the preview on the right. Under it, TeleportHQ shows the rules every new popup starts with: "Opens when the pointer leaves the page on a computer and after 20 seconds on a phone, once every 7 days, on every page. You can change this in Settings."
  5. Click Create popup. While it works, the bottom of the window says "Creating the voucher…", "Preparing your contacts…" or "Creating the popup…", and the window can't be closed.

Check that it worked

The window closes and TeleportHQ says "Your popup is made and switched on. Publish your site to show it.", with an Edit design button. The new popup's card appears in All popups, ringed for a moment. It shows:

  • the popup's name and its switch, set to On;
  • what it's for, for example "Welcome discount · SAVE10";
  • a Publish to apply badge;
  • its rules in one line, for example "Leaving the page · every 7 days · all pages".

Above the cards, a note says "1 popup has changes your live site gets on your next publish." with a Publish button. Visitors see the popup only after you publish: see How to publish your site.

If you chose Create a new code…, the new code is also in your store's Vouchers. If the store's vouchers were off, TeleportHQ switched them on. See How to create discount codes.

Choose when, where, how often and for whom

A TeleportHQ popup's rules live in its settings. To change them:

  1. On the popup's card, click Settings. A drawer opens, titled with the popup's name, for example "Welcome discount settings".
  2. Change what you need:

    SectionChoices
    StatusThe switch: "On — your live site shows it after you publish." or "Off — your live site stops showing it after you publish."
    WhenOn a computer: When the pointer leaves the page, After a few seconds, After scrolling down or As soon as the page opens. On a phone: the same, without the pointer choice. Seconds to wait (1 to 600) and How far down the page (%) (5 to 100) appear when a choice uses them; both screens share the same number.
    WhereAll pages, Only on or Everywhere except. For the last two, add pages with Add a page; remove one with its ✕.
    How oftenEvery few days (with Days between two showings, 1 to 365), Once per visitor or Every visit.
    WhoEveryone, New visitors ("Visitors on their first visit to your site.") or Returning visitors ("Visitors who have been to your site before.").
    Voucher, Promotes or Button (optional)Only for a discount, a promotion, an announcement or something else: the code it hands out, or where its button leads (Where it leads).
  3. Click Save settings. It stays greyed out until you change something. TeleportHQ says "Popup settings saved. Publish your site to put them live."
  4. Publish your site.

How TeleportHQ reads these rules on your live site:

  • Computer or phone depends on the width of the visitor's window: 1,024 pixels or wider uses On a computer; anything narrower, like a phone or most tablets held upright, uses On a phone.
  • When the pointer leaves the page means the pointer moves out through the top of the browser window, toward the tabs or the address bar.
  • How often is remembered in the visitor's browser. Once per visitor shows the popup once in that browser; Every visit shows it again after the visitor closes the tab and comes back. In another browser, on another device, or after the visitor clears their browsing data, it shows again.
  • How often and Who are remembered only for visitors who clicked Accept on your cookie banner. For everyone else, a popup they saw stays closed only while they browse your site; a reload or a later visit counts as a new visit, so Returning visitors popups reach only visitors who accepted.
  • Where never includes checkout, booking, account or admin pages: popups don't open there. Pages that show a different item at each address, like each blog post, can't be picked one by one; the drawer lists them under "Not listed".
  • Welcome discount starts with Who set to Everyone. To show it only on a visitor's first visit, choose New visitors.

Edit the popup's design

Each TeleportHQ popup is a component, so you change its words, colors and pictures in the builder.

  1. On the popup's card, click Edit design (or click the card's picture). The popup opens on the canvas, shown open, with Pages, Components & Tree View open in the left sidebar.
  2. Edit it like any component. Above the canvas, a note says "This is a popup. It opens on your live site by its rules." Its Settings button opens the popup's settings drawer.
  3. To go back, click Back to Popups.

Your popups are kept in the popups folder of your components. Right-click one there for Popup settings or Duplicate. A popup can't be placed on a page: TeleportHQ adds it to your pages itself when you publish.

Switch a popup off, copy it or delete it

  • Switch it off: on the popup's card, click its switch. TeleportHQ says, for example, "“Welcome discount” is switched off. Publish your site to take it off your live site.", with a Publish button.
  • Copy it: click the copy button on the card (tooltip Duplicate popup). TeleportHQ says "A copy of “Welcome discount” is made, switched off."
  • Delete it: click the bin button on the card (tooltip Delete popup), then Delete Popup in the confirmation window. This can't be undone, and your site stops showing the popup on the next publish. To stop showing it for now, switch it off instead.
  • Find a popup: use Search popups… above the cards. The line beside All popups counts them, for example "3 popups · 2 on".

See how a popup performs

Each popup's card in TeleportHQ shows its Last 30 days, for example "Shown 1,204 · Converted 38 (3.2%)", or "Not shown yet".

  • Shown counts each time the popup appeared on a visitor's screen.
  • Converted counts each time a visitor used its main part: subscribed, clicked Copy code, or clicked its button, such as Shop now. Closing it doesn't count, and one showing counts once at most.
  • A newsletter popup also shows "Subscribers from this popup: 12": the people who joined from it and are still subscribed. With several newsletter popups, the line reads "Subscribers from your popups" and counts them together.

The results need visitor analytics. While it's off, the card shows Turn on analytics to see results, which opens Growth Settings; switch on Visitor analytics there and publish. See How to turn visitor analytics on or off and choose tracked pages. The results refresh when you open Popups again, at most once a minute.

What visitors see on your site

  • One popup per page view. When several popups could open on a page, the one whose Where names that page comes first, then one set to Everywhere except, then one on All pages; between equals, the newest. The others wait for a later page.
  • It waits for the cookie banner. If your site shows the TeleportHQ Cookie Consent banner, no popup opens while the banner is on screen. The popup opens once the visitor answers the banner. See How to add a cookie consent banner.
  • Center dims the page, which waits until the visitor closes the popup with the ✕, its close button, a click outside it or the Esc key. Corner and Bottom bar leave the page usable; they close with the ✕, the close button or Esc.
  • A discount popup's Copy code button copies the code and reads "Copied" for a moment. The visitor pastes the code at checkout.
  • A popup's button to a product, a bookable item or a page takes the visitor there and closes the popup.
  • On a site in several languages, the popup opens on every language's version of the pages you chose.

AI tokens used by Popups

When you click Generate or Generate again, TeleportHQ checks that your workspace has at least 300 AI tokens and holds them back. When the design is written, you're charged what the AI really used. If the AI's answer can't be used, TeleportHQ asks once more by itself and doesn't charge you for the refused answer. Starting from a ready design uses no AI tokens. See What uses AI tokens, and how much?.

Troubleshooting

A card in the New popup window is greyed out The reason is written under it. The messages, and what to do:

  • "Newsletter signups are kept by Newsletter. Switch on Newsletter first." Switch on the Newsletter: see How to turn on the Newsletter and collect subscribers.
  • "Newsletter needs the TeleportHQ database. Connect your features to the TeleportHQ database to use it." Your project keeps its people in another database; newsletter popups need the TeleportHQ database.
  • "Discount codes need your store. Switch on E-commerce first." See How to add a store to an existing project.
  • "Your store has no checkout page yet. Create it from E-commerce → Pages, then make the popup."
  • "Your checkout page was made before discount codes existed. Recreate it from E-commerce → Settings → Vouchers, then make the popup."

"Pick what the popup promotes." or "Pick one of your vouchers, or create a code." Choose the item, the page or the code on the first step, then click Next again.

"Press Generate to write the popup from what it should say — or start from a design instead." You chose Write it with AI but nothing was generated yet. Click Generate, or click Start from a design.

"The design could not be generated. Try again in a moment." or "The generated popup could not be used: … Try again, or start from a design." Click Generate again, or click Start from a design.

A card shows "Voucher missing" The discount code the popup hands out was deleted from your store. Click Settings on the card and pick another code under Voucher, or create a new one.

The popup doesn't show on my live site Check these in order:

  1. The card shows Publish to apply: publish your site.
  2. The popup's switch is On.
  3. You already saw it: How often hides it in your browser for a while. Test in a private browser window.
  4. Another popup opened on that page first: only one opens per page view.
  5. The cookie banner is still on screen: answer it.
  6. The page is a checkout, booking, account or admin page, where popups never open.
  7. On a computer with When the pointer leaves the page, move the pointer out through the top of the window.

"Popups open by their rules — manage them in Growth → Marketing → Popups" You tried to place a popup on a page. Popups aren't placed by hand; set their pages under Where in their settings.

Good to know

  • The Newsletter's signup popup is a popup like the others, named Newsletter: a corner card after 12 seconds, every 30 days, for new visitors. Change it here or from the Newsletter's settings. See How to turn on the Newsletter and collect subscribers.
  • The layout is fixed once the popup is made. For another layout, create a new popup.
  • The AI Assistant can help too. In the editor's AI Assistant, you can ask it to list, create, change or copy your popups, or to read their results.
  • On a site in several languages, TeleportHQ can also translate a new popup's text into your other languages.
  • Popups need the published site. The HTML download doesn't open them.
Share

Related Articles

What is the Marketing Studio?

The TeleportHQ Marketing Studio, in the editor's Growth panel, lets you manage the people who sign up to your site, send email newsletters and AI-written email or SMS campaigns through your own sending service, and create AI social posts and graphics to copy or download.

How to turn on the Newsletter and collect subscribers

In TeleportHQ, open Plugins → Newsletter, turn on Newsletter enabled and follow the Activate Newsletter window; then connect your email provider in the Newsletter panel, check the welcome email and publish, so visitors can subscribe from your footer, the signup popup, newsletter blocks, the sign-up form and checkout.

How to create discount codes

In TeleportHQ, switch on Vouchers in E-Commerce Settings, click Manage Vouchers → Add Voucher, type a code, choose the discount and what it applies to, add optional conditions and limits, and click Save voucher; shoppers type the code under Have a voucher? at checkout.

How to add a cookie consent banner

In TeleportHQ, click Cookie Consent in Elements → Primitives → Interactive to add a banner with Accept and Decline buttons and a link to your terms page; Google Analytics and Google Tag Manager wait for Accept, the banner works on websites and web apps alike, and for cookie categories you paste a consent tool's code into Project settings → Custom code.

How to add a pop-up (modal)

In TeleportHQ, you add a pop-up by clicking a card in Elements → Primitives → Modals (Confirmation, Information, Details, Form or Slider), then choosing which element opens it; TeleportHQ wires the close button and backdrop for you, and pop-ups work in websites as well as web apps.

How to publish your site

In TeleportHQ, click Publish at the top right of the editor, keep Production selected, and click Publish to Production; a progress bar beside the button shows each step, and after a few minutes your site is live on a free TeleportHQ address that you can share.