Creating and Configuring Popups
A Popup is the widget shown to your visitors — popup, corner, or banner. Each Popup belongs to a Campaign, made for it automatically unless you group popups yourself, and has its own content, theme, form fields, triggers, targeting filters, and delivery settings.
Popup types
| Type | Description |
|---|---|
| Center | An overlay in the middle of the screen. High visibility; best for high-intent moments. |
| Corner | Anchored to a corner of the viewport (any of the four). Less intrusive; good for persistent offers. |
| Banner | Fixed bar at the top or bottom of the page. Works well for announcements or time-sensitive offers. |
Creating a Popup
- Go to Popups and click New popup. (To add one to an existing Campaign, open the Campaign and click Add Popup.)
- Pick a starting point under Start from: Blank, a template from the Turnjo library, or one your team has saved. The popup is created straight away, named after the template, and opens in the editor with a live preview.
- Change anything you like there: content, type and placement, theme, fields, triggers and targeting.
Picked the wrong starting point? A popup that has never been shown can be deleted from the editor (Delete, top right). Once a popup has been shown or collected a lead, pause it instead: that keeps its leads and stats. 4. When you're ready for visitors to see it, click Publish in the editor. Publishing needs a confirmed email address. If you haven't clicked the link in your confirmation email yet, Turnjo remembers the click and publishes the Popup as soon as you confirm.
Campaigns group popups and give them a schedule. You only need one of your own to run several popups together, or to start and stop them on set dates: New campaign on the Popups page.
Templates
A template is a reusable snapshot of a Popup's content, theme, and fields. To save one, open any Popup in the editor and click Save as template — it becomes available when creating a Popup on any of the account's Properties.
Two things to know:
- Templates are copies, not links. Editing a template later never changes Popups that were made from it, and editing those Popups never changes the template.
- Templates don't carry triggers, targeting, frequency, or delivery settings — those are decisions about where and when, made per Popup.
Saved templates can be deleted from the picker; Popups already made from them are not affected.
The editor
Building a Popup takes four steps, shown across the top of the editor. You can open any step at any time, and Next at the bottom of each suggests the order:
- Design: Content (its screens and their blocks), Style & layout, and Form fields.
- Audience: Triggers (when it appears, and how often) and Targeting (who sees it, and on which pages).
- Integrations: where its leads go, and which field goes where.
- Publish: a check of each step, what's changed since the last publish, and the Publish button. A/B tests start from here too, once the Popup is live.
Within a step, the editor has three panes:
- Sections (left): the current step's sections.
- Canvas (center) — a live preview of the Popup on a mock of your page, exactly as visitors will see it. Click any block to edit it. Toggle Desktop / Mobile to preview both. In Content, the strip of screens above the canvas switches between the Popup's screens; see Screens.
- Settings (right) — the controls for the current section.
Changes autosave a couple of seconds after you stop editing; the save bar in the corner shows the current state, and the Save button forces an immediate save. Undo and redo (Ctrl/Cmd+Z, Shift+Ctrl/Cmd+Z) cover your content edits.
Editing a live Popup
Once a Popup is live, your edits are saved as a draft: visitors keep seeing the published version until you publish the changes. The top of the editor always says which state you're in:
- Live: what you see is what visitors see.
- Live · unpublished changes: you've changed something visitors don't see yet. Click Publish changes to make it live, or Discard to go back to the published version.
- Not published: nobody sees it, so edits save directly. Publish puts it live.
The Popup's name isn't shown to visitors, so a new name saves straight away.
The Content section is built from screens, and each screen from blocks: headings, text, images, buttons, the form, questions, and Columns for side-by-side layouts. See Content Blocks and Layout for what each block does, how columns and their widths work, and what you can upload as an image, and Screens for popups in several steps.
Style & layout
The Style & layout section sets where the Popup sits on the page (its type and position) and styles the whole Popup: every screen shares one theme.
- Colors — background and text, plus optional button, button text, link, and fine-print colors. Blocks without their own colors follow the theme, so changing the theme's button color restyles every button at once. A block can override any color individually; the field is labeled Overrides the theme and offers a ✕ to fall back again.
- Layout — padding, corner radius, and max width.
- On phones (≤640px) — optional mobile values for padding, corner radius, and max width. Anything you don't set inherits the desktop value. The canvas's Mobile toggle previews exactly what a phone will render. Columns blocks stack into one column at this same width — see Content Blocks and Layout.
- Close button (×) — its color, size, an optional circle behind it (with its own opacity, so it can be see-through over a photo), and whether it sits inside the corner or on the edge of the Popup. With a circle and no color of its own, the × turns dark or light to stand out against the circle. You can turn it off: visitors can still close a centred Popup by clicking outside it or pressing Escape, and any Popup with a button set to Close popup.
- Typography — headings and text blocks accept per-block size, weight, line height, letter-spacing, and spacing above/below, with a one-click Reset to theme.
Fonts
Set a default typeface for a Property under Property → Settings → Branding. It applies to every Popup, Tour, and the feedback widget on that Property. Any individual Popup can override it in Style & layout.
There are three kinds of choice:
| Option | What it does |
|---|---|
| Match your site | The widget inherits your page's own typeface. Nothing extra loads — usually the most seamless look. |
| System fonts | Arial/Helvetica, Georgia, Times, Verdana, Trebuchet, Tahoma, Courier. Rendered from fonts the visitor's device already has, so nothing is downloaded. |
| Webfonts | A curated set — Inter, Roboto, Open Sans, Lato, Montserrat, Poppins, Nunito, Work Sans, Source Sans 3, Merriweather, Lora, Playfair Display, JetBrains Mono. |
A webfont is only downloaded when a widget that uses it actually appears on the page — one small file per weight, and never on page loads where nothing shows. Text stays visible while it loads (it renders in a fallback face first, then swaps), so a slow font never leaves a blank widget.
We host these fonts ourselves rather than loading them from Google Fonts. Requesting fonts from Google would send every one of your visitors' IP addresses to a third party, which is a GDPR exposure and would undermine running Turnjo without a cookie-consent banner. Self-hosting means your visitors' browsers only ever talk to your site and ours.
Closing without taking action
Add a Button block and set When clicked to Close popup for a "No thanks" option. It closes the Popup like the ×, so the Popup's frequency limits treat it the same way.
Form fields
| Field type | Use for |
|---|---|
| Text | Name, company, or any short free-text input |
| Email address (always required; included by default) | |
| Phone | Phone number |
| Consent checkbox | An explicit opt-in with a configurable label — use when the visitor is subscribing to marketing (e.g. a mailing list), where consent must be an action they take |
| Consent statement | Notice-only fine print with no checkbox — use when the visitor is already asking you to contact them (e.g. a quote request), where a notice is enough and a checkbox only adds friction |
For both consent types, write the label as plain text with optional markdown links: I agree to the [Privacy Policy](https://yoursite.com/privacy). The link will be clickable in the rendered form. A statement never blocks submission; a required checkbox does.
Triggers — when the Popup fires
Triggers are the firing moment. A Popup can have several; it shows on the first trigger to fire.
| Trigger | Description |
|---|---|
| On page load | Fires as soon as the page loads |
| After time on page | Fires after N seconds |
| At scroll depth | Fires when the visitor scrolls N% down the page |
| On exit intent | On a computer, fires when the mouse leaves through the top of the window. On phones and tablets, which have no mouse, fires when the visitor scrolls quickly back up toward the top, or back to the top after reading down the page, and never in their first 10 seconds. A visitor who leaves without scrolling back up isn't caught, so on short pages a time or scroll trigger reaches more phone visitors. |
| On element click | Fires when the visitor clicks an element matching a CSS selector |
| When an element comes into view | Fires once any part of an element matching a CSS selector is on screen, e.g. the pricing table or the reviews |
Frequency cap — Show again after
New popups show once per browser session: a visitor who closes one doesn't see it again until their next visit. The Show again after setting — the Popup's frequency cap — holds it back once a visitor has seen it:
| Setting | Behavior |
|---|---|
| Every page view | No cap: shows on every eligible page view |
| Once per browser session | The default. Won't reappear until the visitor's next session |
| After 3 more visits, or a number of visits… | Won't reappear until that many visits (browser sessions) after the one they saw it on, 1 to 99 |
| After 5 more page views, or a number of page views… | Won't reappear until they've viewed that many more pages, 1 to 99 |
| After 1, 3, 7, 14, 30 or 90 days, or a number of days… | Won't reappear within the window, counted from when they saw it, 1 to 999 days |
| Never — show only once | One appearance per visitor, ever |
The clock starts when the visitor sees the Popup, whether they dismiss it or just navigate away. Visitors who submit the form never see the Popup again, regardless of this setting.
Appearances are recorded whatever the cap is set to, so tightening the cap later applies to appearances that already happened. Switching a long-running Popup from "Every page view" to "After 30 days" won't show it to a visitor who saw it last week — they're already inside the new window.
After it's closed, show again
After it's closed, show again sets how long a Popup stays away once a visitor closes it with the ×, Escape, a click outside it, or a Close popup button. The clock starts at the close.
| Setting | Behavior |
|---|---|
| Use the setting above | Only Show again after applies |
| On their next visit | Not again until the visitor's next browser session |
| After 3 more visits, or a number of visits… | Not again until that many visits (browser sessions) after the one it was closed on, 1 to 99 |
| After 5 more page views, or a number of page views… | Not again until the visitor has viewed that many more pages, 1 to 99 |
| After 1, 3, 7, 14, 30 or 90 days | Not again until that many days after the close |
| After a number of days… | Any number from 1 to 999 |
| Never show it again | Once closed, it's gone for that visitor |
Both settings apply: the Popup shows only when neither is holding it back. For example, "Every page view" with "After 7 days" keeps the Popup up on every page until the visitor closes it, then hides it for a week. Like the frequency cap, closes are remembered in the visitor's browser.
Closes in analytics
A Popup's analytics page shows how many times it was Closed, and what share of impressions that is. The close rate is also shown per Popup in a site's analytics (Popups by campaign) and in your account's Top Popups. A high close rate with few leads usually means the Popup shows too early, or to the wrong visitors.
Targeting filters — who sees it
Targeting filters limit who is eligible. They don't fire the Popup — that's the trigger's job — they decide whether a visitor qualifies at all.
Targeting is per Popup. If you want to control which sites Turnjo runs on at all, that's the Property's allowed domains setting, not a targeting filter.
| Filter | Description |
|---|---|
| Page URL | Pages whose URL contains — or doesn't contain — a specific string |
| URL Parameter | Only when a query parameter (e.g. a UTM tag) is present or has a specific value |
| Page content | Pages that have — or don't have — an element, some words, or a number in a range (see below) |
| Visit Count | After N visits to the site |
| Visitor Type | New or returning visitors |
| Device Type | Desktop or mobile visitors |
| Country / Region / ZIP + Radius | Visitors inside — or outside — a geographic area |
| Another popup | Visitors who saw, closed, submitted, or chose Yes or No on another of this site's Popups — or never did |
Targeting what's on the page
The Page content filter shows a Popup only where the page has — or doesn't have — something:
- An element: anything matching a CSS selector, such as
.out-of-stockor[data-category="flooring"]. - These words: anywhere on the page, in the page title, in the main heading, or in a chosen element. Not case-sensitive. For example, show a kitchen planning guide on any article whose heading mentions kitchen. A phrase matches its words in that order, and by default inside longer words too: product owner also matches product ownership. Tick Whole words only to match it only as whole words.
- A number: the first number in an element compared with a value, such as a cart total of at least 100 for a free-shipping offer. Prices are read however they're written:
$1,299.00,1.299,00 €.
Several Page content filters match if any one does, so add one per phrase to match any of several. Content that appears a moment after the page loads, as on many shops and single-page apps, still counts. It's all checked in the visitor's browser; nothing about the page is sent to Turnjo.
For an element, type a selector or click Pick on site: your site opens in a new tab, you click the element, and the selector fills in. Prefer stable markers such as an id or a data- attribute; class names and wording can change when the site is redesigned, and the filter then stops matching. Add ?turnjo_debug=1 to a page's address to see in the browser console which filters match.
Following up on another popup
The Another popup filter lets one Popup follow another. Pick the Popup, what the visitor did with it, and whether they did it (Visitor) or never did (Visitor never). For example:
- A discount corner card for visitors who closed the newsletter Popup.
- A demo offer for visitors who submitted the lead magnet.
- An exit-intent Popup for visitors who never submitted the main one.
When the other one is a survey, you can also pick answered it, then a question and the answers that count: any of the listed options for a choice question, or a range for a rating or NPS score (for example 4 to 5 stars, or 9 to 10). That's how a discount goes only to happy customers, or a "talk to us" offer only to unhappy ones. Free-text questions can't be targeted, and their answers aren't kept in the browser.
When Popups follow each other, Targeting shows a Sequence box: what this Popup follows, and which Popups follow it. The Publish step warns when a follow-up points at a Popup that's paused or deleted, when a follow-up shows on page load, and when another live Popup uses the same trigger with no show-again limit, so the two could show back to back.
It's remembered in the visitor's browser, like the show-again settings. Give the follow-up its own trigger, such as time on page or a number of page views, so it doesn't appear the moment the first one closes. "Chose Yes / No" counts answers from when this filter was added.
Including and excluding
The URL and geographic filters each have a Match setting with two options:
| Match | Meaning |
|---|---|
| Contains / Is | The visitor qualifies only if the rule matches |
| Doesn't contain / Is not | The visitor qualifies only if the rule doesn't match |
Use the negative form to keep a Popup off pages it shouldn't interrupt — a
"Doesn't contain" rule of /checkout/ keeps it away from your checkout flow
while leaving it on every other page.
How filters combine: it depends on whether a filter includes or excludes.
- Including filters of the same kind match if any one does — two Country filters mean "either country".
- Excluding filters of the same kind must all hold — excluding
/checkout/and/account/keeps the Popup off both, not just one. - Filters of different kinds must all match — a Country filter plus a Device filter means "that country AND that device".
So a URL "Contains /pricing" together with a URL "Doesn't contain /pricing/enterprise"
shows the Popup across your pricing pages except the enterprise one.
Leave filters empty to show the Popup to everyone the trigger fires for.
Enabling and disabling
Toggle a Popup active or inactive from the Campaign page or the Popup's editor. Inactive Popups are not shown to visitors and do not count toward impressions.
More docs
Getting Started
Popups
Surveys
Guided Tours
Experiments
Visitor Feedback
Integrations
Team & Account
Billing & Plans
Privacy & Compliance