> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/experiences/tours-and-modals.md).

# Tours & Modals

Craft and customize engaging tours & modals with Jimo's Builder, featuring easy navigation, live previews, and a full suite of editing tools.

## What Are Tours & Modals?

**Tours** and **Modals** are the cornerstone experiences within Jimo, designed to **guide, inform, and engage** your users seamlessly. Whether you're onboarding new users or making important announcements, Tours and Modals provide versatile solutions to enhance user interaction directly within your product.

* **Tours:** Sequential groups of steps that guide users through your product's features and workflows. Ideal for onboarding, overviews, and user guides.
* **Modals:** Single-step experiences perfect for simple announcements and contextual pop-ups that capture user attention.

**You will have at the end:** the right format for your message, a tour or a modal, and for each step the user action that moves it forward, on one page or across several.

***

## Tour or modal?

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F4twIJdxHvGECzkoxh8em%2Ftours-02-tour-vs-modal.png?alt=media&amp;token=2ca0eb9c-8034-4b56-8e1f-344060371fea" alt="Decision view: a modal is enough when there is one message on one page; a tour is needed for a workflow in several steps that point at elements or move across pages."><figcaption><p>A modal is a tour with a single step.</p></figcaption></figure>

|               | Modal                                          | Tour                                                                               |
| ------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------- |
| **Steps**     | One                                            | Several, in sequence                                                               |
| **Placement** | In the center of the screen                    | Attached to elements of your app, or in fixed positions                            |
| **Pages**     | One page                                       | One page or several, see [Tours across several pages](#tours-across-several-pages) |
| **Good for**  | Announcements, alerts, quick feedback requests | Onboarding, feature overviews, step-by-step guides for a workflow                  |

Both are built under **Tours & Modals**. If your message fits in one step and users do not need to act on a precise element, a modal is enough.

## Step types

Each step of a tour is one of five step types. What changes from one type to another is where the step shows and which user action moves the tour forward.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FwyYqXWJoYhhiLIror2H9%2Ftours-01-anatomy.png?alt=media&amp;token=97a4d63b-e993-4334-9055-19ff229d0497" alt="A tour of four steps in a row: a modal, a tooltip, a hotspot and a cursor, each with what makes it move forward. Below, any step can also move on with a progress trigger."><figcaption><p>Each step type moves forward on a different user action.</p></figcaption></figure>

| Step type                            | Where it shows                                                | What moves it forward                                                                                               |
| ------------------------------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Modal**                            | In the center of the screen, not attached to an element       | Users click its button                                                                                              |
| **Snippet**                          | In a fixed position on the screen, not attached to an element | Users click its button                                                                                              |
| **Tooltip**                          | Attached to an element of your app, to explain it             | Users click its button, or the highlighted element itself when **To Progress** is set to **Targeted Element Click** |
| **Badge** (hotspot in the assistant) | A pulsing icon pinned to an element                           | Users click its button                                                                                              |
| **Cursor**                           | Pinned to an element users must click                         | Users click that element: use one cursor step for each click users must make                                        |

On any step, a progress trigger can also move the tour on by itself: when users click or reach an element, fill in a field, land on a URL, or after a delay. See [Steps Triggers](https://help.usejimo.com/docs/build/triggers-and-conditions/steps-triggers.md).

Celebration, Pointer and Sticker are variations of these types with preset elements. Every type and its settings are detailed in [Components](https://help.usejimo.com/docs/experiences/tours-and-modals/components.md).

## Tours across several pages

A step shows on the page its element is on. A tour needs no navigation step to change page: the step before takes users to the next page, and the next step starts there.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fp2sip4lWgQgjW5PHYdvR%2Ftours-05-across-pages.png?alt=media&amp;token=71c14155-ed51-4d77-9599-537eb138048e" alt="Step 2 of a tour on the dashboard page takes users to the reports page, either with a url action on its button or with a URL progress trigger; step 3 then starts on the reports page."><figcaption><p>No navigation step: the step before takes users to the next page.</p></figcaption></figure>

Two ways to take users to the next page:

* **A url action on the button** of the step before: the button opens the next page. See [Available Actions](https://help.usejimo.com/docs/build/actions/available-actions.md).
* **A URL progress trigger** on the step before: the tour moves on when users reach the URL of the next page, for instance when they click your app's own link, shown with a cursor step. See [Steps Triggers](https://help.usejimo.com/docs/build/triggers-and-conditions/steps-triggers.md).

Set the page where the tour starts in [Where](https://help.usejimo.com/docs/publish/target-specific-urls-domains-where.md). The steps that follow can appear on other pages of your app.

***

## Overview

### Tutorial: First Tour

{% embed url="<https://youtu.be/7b8Z2JA6hok>" %}
First Tour
{% endembed %}

#### **Tours**

* **Sequential Guidance:** Lead users through a series of steps, each highlighting different features or actions.
* **Contextual Placement:** Attach steps to specific website elements or display them in fixed screen positions.
* **Interactive Flows:** Incorporate CTAs and triggers to create dynamic user journeys, guiding users toward specific actions or pages.

### Tutorial: First Modal

{% embed url="<https://youtu.be/8PGJ-V6T68M>" %}
First Modal
{% endembed %}

#### **Modals**

* **Single-Step Focus:** Deliver concise messages or prompts without the need for a multi-step process.
* **Immediate Attention:** Perfect for announcements, alerts, or quick feedback requests that require user interaction.

***

## Use Cases

Explore our [demo website](https://explore.usejimo.com/dashboard) to see examples of Tours and Modals in action. Choose between different experience examples to see how a tour or a modal can be effectively implemented in context.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FeHjDD58vG6kpPf4vGOjT%2Ftour-example-gif-ezgif.com-video-to-gif-converter.gif?alt=media&amp;token=deb94a0c-170d-4fbf-b945-325029ff552e" alt=""><figcaption></figcaption></figure>

#### **Tours**

* **Onboarding New Users:** Help newcomers understand and navigate your product efficiently.
* **Feature Overviews:** Showcase new or existing features to ensure users are aware and can utilize them effectively.
* **User Guides:** Provide step-by-step instructions for complex workflows or tasks within your app.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FvE7WXQC9A8llDqR77YMQ%2Fimage.png?alt=media&amp;token=6002de7c-99e8-4541-9f68-db878cbf9bcc" alt=""><figcaption></figcaption></figure>

#### **Modals**

* **Announcements:** Inform users about important updates, new features, or promotions.
* **Quick Actions:** Encourage users to take immediate actions, such as subscribing to a newsletter or downloading a resource.

***

## How to Access

1. **Navigate to Experiences:**

   * From your [Jimo dashboard](https://help.usejimo.com/docs/build/dashboard.md), go to [**Tours & Modals**](https://i.usejimo.com/tours).

   <figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FhpY2bcWuVSVsLl2Evlxq%2Fimage.png?alt=media&amp;token=ecb368a0-0d4a-451d-8461-06e050914f38" alt="Tours &#x26; Modals in the dashboard sidebar"><figcaption></figcaption></figure>
2. **Create or Select an Experience:**

   * **First-Time Users:** Click on **"Create Your First Tour"**.

   <figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FYwj6Gh3YMd3rQdFdNV3H%2Fimage.png?alt=media&amp;token=868d2913-bbcd-4f5b-a34d-f11dee84914d" alt="The empty state with Create your first tour"><figcaption></figcaption></figure>

   * **Returning Users:** Click the **+ New Tour** button in the top-right corner.

   <figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FWaYT4erJ4vBfoKixwyNA%2Fimage.png?alt=media&amp;token=f59ce0e7-a935-4f4c-af52-be91928a4448" alt="The + New Tour button, top right"><figcaption></figcaption></figure>
3. **Choose a Template or Start from Scratch:**

   * **Templates:** Select from a variety of prebuilt experiences tailored for different use cases.
   * **From Scratch:** Build your tour step-by-step for complete customization.

   <figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fqv9aBIYXHbGC7p2yxnYC%2Fimage.png?alt=media&amp;token=b3d4c71d-6fdb-4a76-b833-b9b224d540a4" alt="Pick a template or start from scratch"><figcaption></figcaption></figure>

***

## **Main Features**

Jimo's Tours & Modals come with a robust set of features designed to give you full control over your user experiences. Below is an overview of the overall process. For a detailed breakdown of each component specificities, visit our [Components Page](https://help.usejimo.com/docs/experiences/tours-and-modals/components.md).

### Builder

The [Builder](https://help.usejimo.com/docs/build/builders.md) is your central hub for creating and customizing Tours and Modals. It features two main tabs, **Flow Builder** and **Content Builder**, allowing you to manage the structure and content of your experiences seamlessly.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FN0LkLmRjUK4PRtRyZwnh%2F2024-12-13_16-47.png?alt=media&amp;token=c5a49efc-d730-4a3f-9ca7-edcb25d4bad3" alt="The builder: name and back button (A), builder tabs (B), action buttons (C)"><figcaption><p>Builder</p></figcaption></figure>

<details>

<summary><strong>Name and Back Button (A)</strong></summary>

* **Edit Tour Name:** At the very top, you can edit the name of your tour for easy identification.
* **Back to Dashboard:** Use the arrow next to the name to quickly return to the [Dashboard](https://help.usejimo.com/docs/build/dashboard.md) overview of all your tours.

</details>

<details>

<summary><strong>Switch Tabs (B)</strong></summary>

* **Switch Between Builders:** Easily toggle between the **Flow Builder** and **Content Builder** tabs to manage different aspects of your experience.

</details>

<details>

<summary><strong>Action Buttons (C)</strong></summary>

* **Save:** Secure your progress with the 'Save' button, which also automatically saves your work regularly.
* [**In-App Editor:**](https://help.usejimo.com/docs/build/builders/in-app-builder.md) Visualize and edit the tour within the context of your actual website by indicating the starting point URL.
* [**Preview:**](https://help.usejimo.com/docs/build/preview.md) Simulate a full tour to see how it appears and behaves.
* [**Target & Publish:**](https://help.usejimo.com/docs/publish/target-and-publish.md) Set the criteria for who will see the tour and when it will be displayed.

</details>

***

### Flow Builder

The [Flow Builder](https://help.usejimo.com/docs/build/builders/flow-builder.md) tab allows you to design the sequence and structure of your Tour or Modal. Here, you can add, arrange, and connect steps to create a seamless user journey.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FCUo9XX2ATAnBOZuT1HdE%2F2024-12-13_16-40.png?alt=media&amp;token=fca0871d-c7b9-4a40-80b9-530bfeb44c39" alt="The Flow Builder: steps sidebar (A), flow preview (B), step options (C)"><figcaption><p>Flow</p></figcaption></figure>

<details>

<summary><strong>Adding and Managing Steps (A)</strong></summary>

* **Select Step Type:** Choose the type of step you want from the sidebar (e.g., modal, tooltip, snippet).
* **Drag & Drop:** Place and reorder the selected step into your flow effortlessly.

</details>

<details>

<summary><strong>Preview Flow (B)</strong></summary>

* **Flow Overview:** Arrows indicate the progression between steps, while the central view displays each step.
* **Target Element Access:** Quick access to target elements for positioning and trigger settings.

</details>

<details>

<summary><strong>Step Management Options (C)</strong></summary>

* **Rename Step:** Click on the step name to rename it.
* **Reorder Steps:** Use the double arrow icon to move steps up or down in the flow.
* **Duplicate or Delete:** Easily duplicate steps or remove them using the respective icons.

</details>

***

### Content Builder

The [Content Builder](https://help.usejimo.com/docs/build/builders/content-builder.md) tab is where you fine-tune the content and behavior of each step in your Tour or Modal. Customize elements, set behaviors, and ensure everything aligns with your brand and objectives.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FeupmhlodeFWiamS7HXVk%2F2024-12-13_16-46.png?alt=media&amp;token=5bb9be9f-808e-426e-9aea-40bdff5d63a1" alt="The Content Builder: properties (A), builder menu (B), navigator (C), live preview (D), selector (E), step triggers (F)"><figcaption><p>Content</p></figcaption></figure>

<details>

<summary><strong>Properties Sidebar: Elements Editor (A)</strong></summary>

* **Modify Attributes:** Adjust positioning, styling, and animations for the currently selected element in the navigator.

</details>

<details>

<summary><strong>Builder Menu (B)</strong></summary>

* [**Flow Builder Access:**](https://help.usejimo.com/docs/build/builders/flow-builder.md) Switch back to the Flow Builder tab.
* [**Navigator:**](https://help.usejimo.com/docs/build/navigator.md) Manage and edit elements within the step.
* [**Triggers:**](https://help.usejimo.com/docs/build/triggers-and-conditions.md) Add condition-based actions (if/else logic).
* [**Themes:**](https://help.usejimo.com/docs/build/theme.md) Apply consistent styling across your tour.
* [**Translations:**](https://help.usejimo.com/docs/build/multiple-languages.md) Manage multi-language versions.

</details>

<details>

<summary><strong>Navigator (C)</strong></summary>

* **Element List:** See all elements in the current step, with the selected element highlighted.
* **Element Selection:** Click to edit specific elements via the Properties Sidebar.

</details>

<details>

<summary><strong>Live Step Preview (D)</strong></summary>

* **Real-Time Editing:** View and edit elements in the central preview.
* **Element Interaction:** Click on elements to modify content directly.

</details>

<details>

<summary><strong>CSS Selector for Targeted Steps (E)</strong></summary>

* [**Positioning:**](https://help.usejimo.com/docs/build/positioning.md) Use the quick access pop-up to apply CSS selectors to steps needing specific placement. Adjust the position from the step parameters in the sidebar.

</details>

<details>

<summary><strong>Steps Triggers (F)</strong></summary>

* **Advanced Behavior:** Add triggers to define how steps behave based on user interactions or conditions.

</details>

{% hint style="warning" %}
If the [in-app builder](https://help.usejimo.com/docs/build/builders/in-app-builder.md) reloads each time you change steps or if the next button doesn't work, it may be caused by the initial URL where the builder was opened.

To avoid this issue, open the builder out-app and build each step individually by opening the builder in-app on the exact URL where the steps need to appear.
{% endhint %}

***

### A/B Test

The **A/B Test** feature lets you create and compare multiple **variants** of a tour to determine which version best achieves your goals.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FkVQPebUi0ShHAv3nMn0P%2Fimage.png?alt=media&amp;token=a41134ed-b4bf-4080-b9c9-3c4debe264dd" alt=""><figcaption></figcaption></figure>

This allows you to experiment with different flows, designs, or messaging and make data-driven decisions about which version works best.

* Start from your tour’s **Goal settings** to create test variants.
* Each variant can be edited independently in the builder using the **Variant Switch**.
* Jimo will **split traffic randomly** between variants and track performance (completion or event goal).
* Once enough data is collected, you can **set a winning variant as default**, making it the live version for all users.

For the full step-by-step guide, see the [A/B Test documentation.](https://help.usejimo.com/docs/analyze/a-b-test.md)

***

## Best Practices

{% stepper %}
{% step %}
**Keep It Concise**

Design tours with 2 to 5 focused steps targeting specific aspects or features.
{% endstep %}

{% step %}
**Start Small**

Begin with simple, targeted experiences to address key user pain points.
{% endstep %}

{% step %}
**Iterate and Expand**

Gradually build a library of experiences, interconnecting them to create comprehensive user journeys.
{% endstep %}

{% step %}
**Maintain Consistency**

Use themes to ensure all experiences are visually aligned and reflect your brand.
{% endstep %}

{% step %}
**Leverage Segmentation**

Utilize custom attributes to target the right users with the right messages at the right time.
{% endstep %}
{% endstepper %}

***

## From your assistant

> "Draft a tour on the dashboard: a tooltip on the search field, then a cursor on the Tables link, then a tooltip on the Authors table."

Your assistant drafts the tour from steps of the five types, or from a tour template, and pins each targeted step to an element you capture in your app. It prefers a cursor for each click users must make and adds progress triggers, such as a URL trigger when the tour continues on another page. A modal can come from a title, a body, a button and an image or video link. The result carries a preview link that opens the draft in your app: check that every step attaches before you publish.

It cannot upload media or put HTML in the copy, and it never pins a step with a CSS selector. See [What to ask?](https://help.usejimo.com/docs/integrations/mcp/what-to-ask.md).

## Verify

* Open the [Preview](https://help.usejimo.com/docs/build/preview.md) and walk the tour: each targeted step attaches to its element.
* Each step moves on with the user action you chose in the step types table.

## Go further

* [Components](https://help.usejimo.com/docs/experiences/tours-and-modals/components.md): every step type and its settings
* [Show on](https://help.usejimo.com/docs/publish/trigger-on-the-right-spot-show-on.md): start the tour on page load, on an element, on an event, or not automatically
* [Where](https://help.usejimo.com/docs/publish/target-specific-urls-domains-where.md): the page where the tour starts
* [Who](https://help.usejimo.com/docs/publish/target-right-people-who.md): the users who see it
* [When](https://help.usejimo.com/docs/publish/trigger-at-the-right-time-when.md): schedule and frequency
* [Goal](https://help.usejimo.com/docs/publish/mesure-outcomes-goal.md): measure the outcome; an A/B test starts there
* [Steps Triggers](https://help.usejimo.com/docs/build/triggers-and-conditions/steps-triggers.md): move a step on when users do something
* [Available Actions](https://help.usejimo.com/docs/build/actions/available-actions.md): what a button or a trigger can do
* [Chain experiences](https://help.usejimo.com/docs/build/actions/chain-experiences.md): start a tour after another experience
* [Experience links](https://help.usejimo.com/docs/build/actions/experience-links.md): a button that launches another experience
* [Analytics](https://help.usejimo.com/docs/analyze/analytics.md): how tour views, completions and dismissals are counted
* [Hints](https://help.usejimo.com/docs/experiences/hints.md) and [Checklists](https://help.usejimo.com/docs/experiences/checklists.md): a hint for help on one element, a checklist task that launches a tour

**Next page:** [Components](https://help.usejimo.com/docs/experiences/tours-and-modals/components.md)
