# Flow Builder

## **Understanding the Flow Builder**

The **Flow Builder** is designed to simplify how you create and manage multi-step that follow a sequential logic, like **Tours & Surveys**.&#x20;

It provides a **visual representation of the step progression**, allowing you to easily **add, reorder, and connect steps**. Instead of navigating through individual steps via a top bar, you now have a **global view of the entire journey**.&#x20;

* **Tours**: Focus on guiding users through a multi-step journey based on conditions.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FoI50zTZDXBDIVHEptZFY%2Fimage.png?alt=media&#x26;token=967d0925-e5ee-400d-85fa-d2f05933aa76" alt=""><figcaption></figcaption></figure>

* **Surveys**: Collect responses step by step, with logic-driven flows based on the answers.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fjuad1RvjPEv1JPBl0LCU%2Fimage.png?alt=media&#x26;token=d1fe846f-95f8-4eb6-9576-3f450512fe99" alt=""><figcaption></figcaption></figure>

Easily switch between steps, visualize progress, and manage the flow in one centralized interface.

> 📝  For **single-step** or unordered experiences (e.g., **Banners, Hints, Checklists**), the **Flow Builder isn’t needed**, and the **Content Builder** is used instead.

***

## **First Time in the Flow Builder**

To access the **Flow Builder**, follow these steps:

1. **Creating a New Experience**:

   * After clicking **Enter Builder** when creating a new **Tour or Survey**, you land directly in the Flow Builder.
   * This is where you add your first step before moving to customization.

   <figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FTsFtxbvfuLKzGL0lDihH%2Fimage.png?alt=media&#x26;token=a9ec8ba1-d9d1-457a-9069-164002002872" alt="" width="563"><figcaption></figcaption></figure>
2. **Returning to the Flow Builder**:

   * From the **Content Builder**, click the **Flow tab** in the **Top Bar**.
   * Alternatively, use the **“+” menu icon** in the left sidebar to return to the Flow Builder and add new steps.

   <figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FXC7X9oLzbyPxOgSUu0l8%2Fimage.png?alt=media&#x26;token=1abcdd53-b88a-470f-a5e1-001b4621354c" alt="" width="563"><figcaption></figcaption></figure>

> 📝  If you're working on **Banners, Checklists, or Hints**, there’s no Flow tab, as these experiences don't require step sequences.

***

## Adding Steps

In the **Flow Builder**, the **right sidebar** provides a list of step types available for the selected experience type.

### **How to Add a Step**

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FFlKZ4RfS59XE6b8bS1MV%2Fimage.png?alt=media&#x26;token=8de6bbe8-a543-4722-91b7-b7da17a429d9" alt=""><figcaption></figcaption></figure>

* **Drag & Drop** a step from the **sidebar** into the **flow preview**.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fu0Pz8pnZhi0bygIN3t8f%2Fimage.png?alt=media&#x26;token=34c14cf8-9615-4b26-9bb8-996c20a47f7c" alt=""><figcaption></figcaption></figure>

* After placing a step, you’ll be **redirected to the Content Builder** to customize its content.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FjsRocBcrWp29A57rQkPN%2Fimage.png?alt=media&#x26;token=e5949d4b-b2f0-4a20-9c9d-373d3145e40c" alt=""><figcaption></figcaption></figure>

### **Step Types by Experience**

<details>

<summary><strong>Tours</strong></summary>

Steps differ mainly in **style and placement**:

* **Fixed Steps**: Positioned relative to the screen (e.g., Snippets, Modals).
* **Targeted Steps**: Attach to a specific **UI element** (e.g., Tooltips, Badges).

More details in the [tours components](https://help.usejimo.com/docs/experiences/tours-and-modals/components).

![](https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FsmYrVYI0zNqJIGZOOKPI%2Fimage.png?alt=media\&token=d6d0edb3-834e-4564-8441-ec30323db1b3)![](https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FC5z5oKLeoNL0T3WGk7ys%2Fimage.png?alt=media\&token=54158ffd-e964-42e9-a17f-6732718eee7e)![](https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FT3NCHkNsNdcBRGI27JSA%2Fimage.png?alt=media\&token=fda337fb-c6e1-478a-93c1-b9198fa72b10)

</details>

<details>

<summary><strong>Surveys</strong></summary>

* Steps are primarily **interaction types** (e.g., MCQs, NPS, Open Questions).

More details in the [surveys components](https://help.usejimo.com/docs/experiences/surveys/components).

![](https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FXI6Bfny9s3QYZ6AzAiRy%2Fimage.png?alt=media\&token=08c1ff16-bece-4c26-ad00-d0e692cb81e2)![](https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FmdlUBnRwJthd6arIAuJL%2Fimage.png?alt=media\&token=1c2f05f9-1336-49ca-aa6d-1507cb9368cd)

* You **choose one style** (from Tour step types) for the entire survey.

<img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FAkaChdyruW7RAwomHMrj%2Fimage.png?alt=media&#x26;token=99f30adc-daa7-443f-a7b5-d43c01df0869" alt="" data-size="original">

</details>

***

## **Steps Management**

The **Flow Builder** allows you to organize steps efficiently, rename them, and overview how users progress between them.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FyNsOrmyVhop5VFQM9Nxt%2Fimage.png?alt=media&#x26;token=38828e72-97b9-420f-93d6-afe883199027" alt=""><figcaption></figcaption></figure>

### **Quick Actions in the Flow View**

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F2Jmnv41loBRIGk92EzsD%2Fimage.png?alt=media&#x26;token=944990e9-55ed-48f2-85cd-ef79ee98a60d" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Rename a Step (A)" %}
Double-click the **step name** at the top of each step.

<mark style="color:blue;">(In</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Legacy or In-App Builder**</mark><mark style="color:blue;">, this can be done from the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Navigator main section**</mark><mark style="color:blue;">.)</mark>
{% endtab %}

{% tab title="Rearrange Steps (B)" %}
Use the **double arrow icon** to **drag and drop** a step within the flow.

<mark style="color:blue;">(In</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Legacy or In-App Builder**</mark><mark style="color:blue;">, this can be done from the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Top Bar**</mark><mark style="color:blue;">.)</mark>
{% endtab %}

{% tab title="Duplicate a Step (C)" %}
Click the **copy icon** to make an exact duplicate.

<mark style="color:blue;">(In</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Legacy or In-App Builder**</mark><mark style="color:blue;">, this can be done from the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Top Bar,**</mark> <mark style="color:blue;"></mark><mark style="color:blue;">just add a step and select the copy preset.)</mark>
{% endtab %}

{% tab title="Delete a Step (D)" %}
Click the **trash icon** to remove it.

<mark style="color:blue;">(In</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Legacy or In-App Builder**</mark><mark style="color:blue;">, this can also be done from the</mark> <mark style="color:blue;"></mark><mark style="color:blue;">**Top Bar**</mark><mark style="color:blue;">.)</mark>
{% endtab %}
{% endtabs %}

### **Flow Visualization & Step Progression**

The **Flow Builder** provides **visual indicators** for how users move between steps:

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FNhhIXumjOqRsZTvbOZcV%2Fimage.png?alt=media&#x26;token=77fcaa34-0746-44c4-a2aa-df2d765a8473" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="Progress Arrows (A)" %}
**Arrows** show **progression paths** from a step’s **CTA, trigger, or target** to the next step.
{% endtab %}

{% tab title="Behavior Quick Access (B)" %}
**Clicking on an arrow or its origin** grants **quick access** to the relevant Content Builder settings.
{% endtab %}

{% tab title="Targeted Elements Preview (C)" %}
**For targeted steps**, the **target element** is displayed **above the step box** for easy access.
{% endtab %}
{% endtabs %}

### **Quick Access Controls**

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FVHXSrfzfNfNDXsMwXtLz%2Fimage.png?alt=media&#x26;token=0655d726-15a1-416a-90ef-ddd261fc3fcc" alt=""><figcaption></figcaption></figure>

Even while in the **Flow Builder**, you still can:

* **Click any step** to open its **parameters in the Content Builder**.
* **Modify triggers/conditions** directly from the quick access bar below each step.
* **Adjust targeting** for UI-attached steps using the quick-access icon **above** them.
