Create your first flow

3 min readUpdated 2026-05-19

What you'll build

In this guide you'll create a simple 3-step tour that walks new users through a key feature of your app. By the end, the tour will be live and showing to real users.

Prerequisites

Step 1 — Open your app

Navigate to the page in your app where you want the tour to start. The Chrome extension works on your live site — you're building on top of your real UI.

Step 2 — Open the extension

Click the Zenstep icon in your Chrome toolbar. If you're not already logged in, you'll be prompted to sign in to your Zenstep account.

The extension sidebar opens on the right side of your browser window.

Chrome extension sidebar open on the right side of the browser
The Zenstep extension opens as a sidebar — click the puzzle icon in Chrome to pin it

Step 3 — Create a new flow

In the extension sidebar, click New FlowTour. Give it a name (e.g. "Onboarding tour").

Step 4 — Add steps

Click Add step. The extension enters element-selection mode — your cursor changes to a crosshair.

Click on any element on your page to anchor a step to it. A card editor appears where you can:

  • Write a title (optional)
  • Write the body text explaining what the element does
  • Choose how users advance: Next button (they click a button) or Target click (they click the element itself)
Element selection crosshair cursor and step editor panel
Click any element on the page to anchor a step to it

Repeat to add more steps. A typical first tour has 3–5 steps covering your core feature.

💡

Keep each step to one idea. Users read tooltips quickly — a single sentence is often better than a paragraph.

Step 5 — Set targeting

Click the Targeting tab in the extension sidebar. Add a URL rule to show the tour only on the relevant page:

  • Rule type: URL path
  • Operator: starts with
  • Value: /dashboard (or whatever path your feature lives at)

You can also add a frequency setting:

  • Once — show to each user one time only (recommended for onboarding)
  • Every session — show on every page load
  • Until completed — show until the user finishes all steps

Step 6 — Preview

Click Preview in the extension sidebar to see your tour running live in your browser. You'll see it exactly as your users will.

Make any edits needed. You can click any step in the sidebar to jump to it.

Step 7 — Publish

When you're happy with the tour, click Save in the extension, then go to the dashboard and click Publish on the flow's settings page.

Once published, the flow will start showing to users who match your targeting rules.

Verifying it works

Open your site in an incognito window (so you appear as a new user). Navigate to the target URL. The tour should appear automatically.

ℹ️

If the tour doesn't appear, check the troubleshooting guide for the most common causes.

Next steps

Was this helpful?