Adding steps

Each step is one tooltip anchored to a DOM node on your site.

Fields

Selector — any valid CSS selector that resolves to a visible element.
Title & message — concise headline plus supporting copy.
Position — top, bottom, left, or right relative to the element box.

Ordering

Reorder steps in the dashboard — runtime order follows your saved sequence.

Trigger URL (Context-Aware Tours)

What is a Trigger URL?

By default TourKit runs in linear mode — all steps show on every page, once per visitor.

When you set a Trigger URL on a step, TourKit switches to context-aware mode. Each page gets its own focused tour.

How to set it

In the step editor, find the Trigger URL field below the CSS Selector input. Enter the URL path for that step:

/dashboard
/projects
/settings
/pricing

How it works

Setup	Behavior
No steps have Trigger URL	Linear mode — all steps on every page, one seen flag
Any step has Trigger URL	Context-aware mode — each page gets own steps
Steps without Trigger URL	Root only — shows on /
Steps with Trigger URL	Shows only on matching path
Page with no matching steps	No tour shown

Real world example

Step 1: no url → shows on / (welcome)
Step 2: no url → shows on / (feature overview)
Step 3: url = /dashboard → shows on /dashboard only
Step 4: url = /projects → shows on /projects only
Step 5: url = /settings → shows on /settings only

Result:
- / → steps 1 and 2
- /dashboard → step 3 only
- /projects → step 4 only
- /settings → step 5 only
- /other → no tour

Wildcard matching

Use * at the end for prefix matching:

/projects* matches:
/projects
/projects/123
/projects/123/edit