Guided Product Tours
Tours walk visitors through your site with a sequence of tooltips — great for onboarding, feature announcements, or explaining a workflow. Each step can point at an element on the page, show text or rich content, and even include a video.
Tours run through the same embed script as your Popups.
Building a tour
- Go to Tours and click New tour, then pick how it starts: a Welcome message (one step), a Short walkthrough (three steps), or Blank. The tour is created on your homepage and opens straight away.
- Add steps. The easiest way is Add steps on your site: your site opens with a panel, you click the button, menu or section a step should point at, write the step there, and save. Or click Write a step here to add one in Turnjo. For each step you can set:
- Title and body text (or use content blocks for richer layouts)
- A target element to anchor the tooltip to, picked on your site or typed as a CSS selector. Leave it empty for a centered box.
- Placement: auto, top, bottom, left, or right (auto picks the best fit)
- A page URL to navigate to before showing the step (for multi-page tours)
- Spotlight, to dim the rest of the page and highlight the target (advanced)
- A video, from YouTube or Mux (advanced)
- Custom Next / Back button labels
- Click Preview to play it on your site, then Publish at the top of the tour's page. A tour needs at least one step to publish.
Changes to when a tour starts and who sees it save as you go.
When a tour appears
Choose a trigger:
- When a page opens: the tour starts automatically when the visitor lands on a matching page. Choose a match type — matches (exact), starts with, contains, ends with, matches pattern (
*wildcards), or matches regex — and enter the value. Leave it blank to start on every page. - When something is clicked: the tour starts when the visitor clicks a specific element.
You can also layer on an Audience — the same targeting rules used by Experiments and Popups (device type, visitor type, URL contains, time on page, scroll depth, visit count, exit intent, and location: country / region / ZIP radius). Rules of the same kind match if any one does; different kinds must all match for the tour to run. Audience targeting is part of advanced tour features.
A visitor who finishes or dismisses a tour won't see it again. Multi-page tours resume where the visitor left off after navigating.
Navigation
Steps show "Step X of N" with Back and Next buttons; the last step's button reads Finish. Visitors can close a tour at any time with the dismiss button.
Tracking
Turnjo records tour events — started, advanced (per step), completed, and dismissed — so you can see how far visitors get. Completion analytics are available from the tour's page.
Remembering completion across devices
By default a finished tour is remembered in the visitor's browser, so it won't reappear on that device. If you tell Turnjo who a signed-in visitor is, completion is remembered on the server too — so a user who finishes a tour on their laptop won't see it again on their phone.
Identify a visitor with their stable user id and a signature your server computes from it, so nobody can pose as another user by typing their id into the browser:
- Copy the identity secret from the Property's Settings → Identified Visitors. Keep it on your server; never put it in page source.
- On your server, compute an HMAC-SHA256 of the user id, keyed with the secret, as a hex string.
- Add both to the Turnjo embed script tag:
<script async src="https://cdn.turnjo.com/embed.js?token=YOUR_PROPERTY_TOKEN"
data-user-id="USER_ID"
data-user-hash="SIGNATURE"></script>
In PHP the signature is hash_hmac('sha256', $userId, $secret); in Node, crypto.createHmac('sha256', secret).update(userId).digest('hex'). Instead of attributes you can set window.turnjoUserId and window.turnjoUserHash before the script loads.
An id without a valid signature is ignored, and that visitor is treated as anonymous, with browser-only memory. If the secret leaks, Regenerate secret on the same page; signatures made with the old secret stop working immediately, so update your site at the same time.
Plan limits
Your plan caps how many tours you can create and how many steps each can have. Video, spotlight, and click triggers require a plan that includes advanced tour features. See Billing & Plans.
More docs
Getting Started
Popups
Surveys
Guided Tours
Experiments
Visitor Feedback
Integrations
Team & Account
Billing & Plans
Privacy & Compliance