> 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/build/actions/experience-links.md).

# Experience links

See which experiences an experience launches, which ones launch it, and whether each link will work for your users.

An experience link exists every time one experience starts another. The builder draws these links around the experience you are editing, with the state of each linked experience, so you can follow a whole journey and catch a link that won't work before your users do.

## What are experience links?

A tour button that launches a checklist, a checklist task that launches a tour, a Resource Center action that embeds a checklist, a survey answer that launches a follow-up: each of these is a link.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fa2YLoJudlusVjgpqvsmY%2Fexperience-links-17-journey.png?alt=media&amp;token=815b8a9c-0683-42c8-acf6-aeee6e2d974e" alt="A journey of linked experiences: a Resource Center embeds a checklist, a checklist task launches a tour, the tour launches two modals, and an NPS answer launches the same follow-up modal."><figcaption></figcaption></figure>

Links change nothing for your users. A link launches exactly what the Launch experience action launched before. What changes is what you see while building.

## Where links come from

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FBMuf6UKK7lhbztAAy6Gl%2Fexperience-links-16-sources.png?alt=media&amp;token=0b101053-fe04-4812-9688-b3fb63562c08" alt="Six things can hold a link: a button, a progress trigger, a survey condition, a checklist task, a Resource Center action and a custom answer. Each one uses the Launch experience action to start a target experience."><figcaption></figcaption></figure>

| Link held by                    | Builder                                | What it does                                                |
| ------------------------------- | -------------------------------------- | ----------------------------------------------------------- |
| Button                          | Tours, modals, surveys, banners, hints | Launches an experience, or opens a post                     |
| Progress trigger                | Tours                                  | Launches an experience                                      |
| Survey condition                | Surveys                                | Launches an experience for the selected answers             |
| Checklist task                  | Checklists                             | Launches an experience                                      |
| Resource Center action or block | Resource Center                        | Launches an experience, opens a post, or embeds a checklist |
| Custom answer                   | Agent                                  | Launches an experience                                      |

Links created through the Jimo MCP show up and work like the others.

## Create a link

{% stepper %}
{% step %}

### Select what will launch the experience

A button, a progress trigger, a survey condition, a checklist task, a Resource Center action or block, or a custom answer.
{% endstep %}

{% step %}

### Add the Launch experience action

In **Behavior**, choose **Launch experience**. The **Start experience** picker opens.
{% endstep %}

{% step %}

### Pick the target

Experiences are grouped by type: tours and modals, surveys, checklists, hints, Resource Centers. An experience that is not live carries its state (for example **Draft**). The experience you are editing is never listed.
{% endstep %}

{% step %}

### Check the link

The action now shows the target's name, a port appears on the button, task or trigger, and the builder saves on its own.
{% endstep %}
{% endstepper %}

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FUmgKFrCxfN58HMR1oa4b%2Fexperience-links-05-picker.png?alt=media&amp;token=455ab231-4777-4476-8304-541287d0323e" alt="The Launch experience popover. The Start experience picker lists tours and modals, with Paused, Draft, Scheduled and Expired badges on experiences that are not live."><figcaption></figcaption></figure>

{% hint style="info" %}
On a checklist task, Launch experience also adds a completion condition, **Experience is seen**, so the task ticks itself once users have seen the launched experience. You can remove it. Removing the Launch experience action removes it too.
{% endhint %}

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FLaMYQgxQI06b2W6rZ6Pb%2Fexperience-links-06-has-seen.png?alt=media&amp;token=a7b453e1-d84a-4f59-9c42-ace640918cfd" alt="The Mark task as completed popover with the condition Experience is seen, then Mark as completed."><figcaption></figcaption></figure>

## Read the links in the builder

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FDJ3gGsH8YCEHvXU8r2Wz%2Fexperience-links-01-anatomy.png?alt=media&amp;token=4a578641-8882-4c23-ac3d-6e7384b00a35" alt="A tour step with two buttons. The Show me button has a green port linked to an experience block, the Later button a grey port linked to a block marked Won&#x27;t launch. Two incoming links point to the step."><figcaption></figcaption></figure>

#### Ports

Each button, task, action or trigger that holds a link shows a port. Click it to unfold or fold the linked experience.

#### Linked experience block

An unfolded link shows the linked experience: a preview, its type and name, a sentence that says what launches it (for example "Launched by “Show me” button · Step 2 · Pick a path"), and **Open**, which opens it in a new tab. Its border takes the colour of the link's health.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FGT9Wk5WbAaQKRwIIXJIt%2Fexperience-links-12-linked-blocks.png?alt=media&amp;token=5a4d859b-3306-40e1-a7d8-42ae1329cec1" alt="Three linked experience blocks: a paused target with the line Paused: won&#x27;t launch for users, a live target with a green border, and a draft target with the line Draft: won&#x27;t launch for users. Each says what launches it and offers Open."><figcaption></figcaption></figure>

#### Incoming links

When other experiences launch the one you are editing, a pill before the first step shows how many lead here. Each source shows its state and what launches it. Edit an incoming link from its source.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F0MYs49xrax1oDPqgV4Y8%2Fexperience-links-11-incoming.png?alt=media&amp;token=01704ce5-18dd-490d-ba27-8af07e423e16" alt="Two incoming links before the first step of a tour: a checklist task and a Resource Center action both launch this tour."><figcaption></figcaption></figure>

#### Show every link at once

Press **L** to unfold every link. Press **Esc** to fold them back.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FJ52AIZFngRDNEdtKerFR%2Fexperience-links-07-unfold-all.png?alt=media&amp;token=b6dcc7ce-028a-4df4-9222-cc3955ffc9cd" alt="A three-step tour with every link unfolded: incoming links on the left, linked experiences under and beside the steps, and a red block for a deleted target."><figcaption><p>Press L to unfold every link.</p></figcaption></figure>

#### Checklists, Resource Centers, banners and hints

These are shown at their real position on screen, and the linked experiences open beside the widget.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FLSkAGiVmV5QPSOQE5biH%2Fexperience-links-08-checklist-stage.png?alt=media&amp;token=28c22673-30f0-410c-9679-77bf27022550" alt="A checklist shown at its real position. Each task holds a link to a tour or a modal, shown beside the widget, and a Resource Center that embeds the checklist links in from the left."><figcaption></figcaption></figure>

## Link health

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FccSVeaa5hYNE55hZ9pxW%2Fexperience-links-02-link-health.png?alt=media&amp;token=13af62ec-bb55-4d75-a2a1-fd78d14982f3" alt="Four links from a button: green for live, grey for paused or draft, yellow for scheduled or expired, red and dashed for a deleted experience."><figcaption></figcaption></figure>

| Target state         | Colour      | What happens for your users                                     |
| -------------------- | ----------- | --------------------------------------------------------------- |
| Live                 | Green       | The target launches, if the user matches its audience           |
| Paused or draft      | Grey        | Nothing launches until the target is live                       |
| Scheduled or expired | Yellow      | Nothing launches until the target is live                       |
| Deleted              | Red, dashed | Nothing launches. The block reads "This link points at nothing" |

Pausing, unpublishing or deleting a target never removes the link.

{% hint style="warning" %}
A link to a target that won't launch still ends the experience users are in. The current tour or checklist closes and nothing replaces it. Check the colour of every link before you publish.
{% endhint %}

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FFkVjHR0y1ZTsucJU9MnB%2Fexperience-links-04-not-live.png?alt=media&amp;token=8f9e58de-0e13-472e-abb9-fdb186ce1e7a" alt="A user clicks Show me in a tour step, the tour closes, and nothing shows because the target won&#x27;t launch."><figcaption><p>A link to a target that won't launch still closes the current experience.</p></figcaption></figure>

{% hint style="info" %}
A green link means the target is live, not that every user will see it. When a link launches it, Jimo checks only the target's **Who**: a user outside its audience sees nothing. Its Where and When are ignored, so it shows on the page the user is on.
{% endhint %}

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fmo1KplV8tK9E71O1HSFa%2FR242-g02-launched-vs-own.png?alt=media&amp;token=031c6952-0c05-48a4-a78b-e892d5fe3821" alt="Two rows: an experience that shows on its own checks pages, devices, frequency and audience; an experience launched by an action checks only its audience, on any page and device, each launch"><figcaption></figcaption></figure>

#### Target & publish issues

Every link that won't work is listed in the **Target & publish** issues, for example "Target experience is a draft", with the button, task or trigger that holds it and its target. Click a row to go to it.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F8fIiSARrbHvzDzaLP61z%2Fexperience-links-09-issues.png?alt=media&amp;token=38d9052c-dec0-42f8-b12f-adaa3843fa8c" alt="The issues list: 3 issues detected. Target experience is paused, Target experience is a draft, Target experience was deleted, each with the button or trigger and the step that hold the link."><figcaption></figcaption></figure>

#### Links that block publishing

A link to a **draft** or **deleted** experience is an error: you can't publish the experience, or publish changes to it, until you fix the link. A link to a **paused**, **scheduled** or **expired** experience is a warning: you can still publish.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FvthvBUS15G1scfI2zpLF%2Fexperience-links-03-publish-rules.png?alt=media&amp;token=c4bc73fc-5d37-4015-8923-61322772c714" alt="Links to a draft or deleted experience are errors that block publishing. Links to a paused, scheduled or expired experience are warnings: you can still publish."><figcaption></figcaption></figure>

## Edit or remove a link

#### Change the target

Pick another experience in the **Launch experience** action. The link is updated in place.

#### Remove a link

Remove the Launch experience action. **Cmd/Ctrl + Z** right after brings it back, with its "Experience is seen" condition on a checklist task.

#### Fix a link to a deleted experience

The block offers **Edit link** to pick a new target, and **Remove**.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FLUUjLJMqm9bO9HzlQojp%2Fexperience-links-10-deleted.png?alt=media&amp;token=675e1446-43fc-41cd-9be3-82f2f16ced76" alt="A red dashed block reading Users click, nothing happens and This link points at nothing, with Edit link and Remove."><figcaption></figcaption></figure>

#### Delete what holds a link

Deleting a button, task or hint that holds a link tells you so before it goes.

## Good to know

* An experience cannot launch itself.
* A button or a progress trigger launches one experience at most.
* A button or a progress trigger never launches an experience and goes to a step at the same time.
* Launching an experience closes the one the user was in.

## Related

* [Chain experiences](https://help.usejimo.com/docs/build/actions/chain-experiences.md): show one experience after another.
* [Available Actions](https://help.usejimo.com/docs/build/actions/available-actions.md): the Launch experience action and the actions it combines with.
* [Steps triggers](https://help.usejimo.com/docs/build/triggers-and-conditions/steps-triggers.md): progress triggers.
* [Checklists components](https://help.usejimo.com/docs/experiences/checklists/components.md): checklist tasks.
* [Resource Center components](https://help.usejimo.com/docs/experiences/resource-center/components.md): actions and blocks.
