"Guided tour or tooltip? How to pick the right step type"

By Hasan · November 5, 2026 · 3 min read

A guided tour is a sequence of steps. A tooltip is one pointer at one element. Many tours fail because every step is a tooltip, including the ones that should be something else. This post says which step type fits which job.

What step types can a tour have?

In JustOneCX a step can be a tooltip, a modal, a banner, a checklist or an end step. Each has one job.

Step type Use it to
Tooltip Point at an element and say one thing about it
Modal Welcome the person or ask for a decision, in the middle of the screen
Banner Tell the person something that does not need a pointer
Checklist Give a list of tasks in a progress widget the person works through in any order
End step Say what to do next

When is a tooltip the right step?

Use a tooltip only when you are pointing at something the person needs to touch or read. A tooltip that points at nothing in particular is a modal in disguise.

Good tooltip steps have a stable target. Besides a CSS selector, a step can find its element by visible text, an ARIA role with an accessible name, or a data-jcx anchor. Text and role targets keep working when generated class names change.

When is a modal the right step?

For the first step and the last. A short welcome that says what the tour will help with, and an end step that says what to do next. Do not use a modal in the middle of a task, because it hides the screen the person is trying to learn.

When is a checklist better than a tour?

When the tasks do not have to happen in order, or when they span days. A checklist stays in the corner of the page with a progress indicator. A person completes a task by clicking it, or a task can be completed by an event your app sends.

How many steps should a guided tour have?

Three to five. Fewer steps beat more. If you have more to say, split it into several short tours, each on its own topic, or move the extra items into a checklist.

A simple pattern

  1. A modal that states the value in one line.
  2. Two or three tooltips on the things the person must use.
  3. An end step that points at the next action.

You can plan a tour with the product tour planner and read more in product tour best practices and the guide to building a multi-page product tour.

See it working in 2 minutes

Try the live demo

Related