# Creating and managing guide journeys

The **Journeys** feature allows you to group multiple walkthrough guides from a selected application into a single list to track the overall completion progress.

## **Understanding journeys**

Journeys help users monitor their progress across related guides, displaying completion status as a percentage within [**Context help**](https://docs.nexthink.com/platform/user-guide/adopt/creating-guides#defining-conditions-to-include-guides-in-context-help) popups. Expandable views allow users to see which guides are included in a journey and which guides they have already completed.

Whenever a user completes a guide, the context help view automatically updates the information. Completed journeys remain visible to users.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2FZnnhYZyTXFVH7kvzCBY1%2Fimage.png?alt=media&#x26;token=293ba7fe-e99c-4135-a098-7d0dd4bd9cd3" alt=""><figcaption></figcaption></figure>

## Creating and configuring journeys

Access journeys from the **Adoption content tab** > **Journeys subtab** within a selected application.

To create a journey, select **New journey** from the top right corner of the page.

1. Define basic settings for your journey.
   * **Name:** Input a name for your journey.
     * This is the name that is displayed to users in context help.
   * **Description:** Input a short description for your journey.
     * This is only visible to administrators.
2. Define a **composition** for your journey:
   * Use the search bar to find and add guides by name.
     * Only published guides are visible to end users, but you can include unpublished guides in the composition.
     * Each guide can be assigned to multiple journeys.
     * If all available guides are added, the search bar will disappear.
   * Arrange the order of guides using drag and drop.
   * Remove a guide by clicking the bin icon, which appears on hover.
3. Set **conditions** that define when the journey is accessible via **Context help**.
   * These conditions relate to:
     * Whether the user has viewed or completed this journey.
     * Whether the user has viewed or completed related journeys.
     * Browser language settings.
     * The frequency at which the journey is shown to the user.
     * Predefined [custom fields](https://docs.nexthink.com/platform/user-guide/administration/content-management/custom-fields-management), such as User attributes or Device attributes, to create rule-based conditions.
     * Predefined [key pages](https://docs.nexthink.com/platform/user-guide/applications/configuring-applications/configuring-web-applications/key-pages).
   * When displayed to users, journey conditions take priority over the conditions set for individual guides. This ensures users see the whole journey instead of individual guides within it.
4. **Save** your journey. It will not be visible to users until you **activate** it. See [Managing journeys](#managing-journeys) below.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-485356c220c28b690568543db511c63c154e6443%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## **Managing journeys**

Journeys are displayed in a table, with a search bar available for filtering. The table features the following columns:

* **Active:** Displays whether each journey is currently visible to users. Use the toggle button to define activity status.
  * Active journeys are displayed to all users.
  * Deactivating a journey requires confirmation via a prompt.

{% hint style="warning" %}
An inactive journey is not visible to users, but individual guides are unaffected.
{% endhint %}

* **Name:** Displays the name of each journey.
* **Description:** Displays the administrator-defined description of each journey.
* **Last update:** Displays the exact time and date when each journey last underwent configuration changes in `DD/MM/YYYY HH:MM:SS` format.
* **Action menu:** Gives you the option to **Edit** or **Delete** a journey.

<figure><img src="https://268444917-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxJSUDk9NTtCHYPG5EWs3%2Fuploads%2Fgit-blob-04bdcae86ff524fd0e4b1074618482f95cbdec9f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

### Journey analytics integration

Whenever guides are launched from a journey, they trigger an NQL event that can be tracked via [Investigations](https://docs.nexthink.com/platform/user-guide/investigations). This information is stored in the `trigger_method` field from `web.guide_executions` table.

**Example**

The following query retrieves the number of times the "Welcome guide" within the "Kanopy corp" application was launched:

* Automatically
* Manually as a standalone guide
* Manually from a journey.

{% code overflow="wrap" lineNumbers="true" %}

```
web.guide_executions
| where application.name == "Kanopy corp" and guide.name == "Welcome guide"
| summarize automatically = number_of_executions.sumif(trigger_method  in [auto_started]), manually = number_of_executions.sumif(trigger_method  in [context_help, manual]), journey = number_of_executions.sumif(trigger_method in [journey])
```

{% endcode %}

***

RELATED TOPICS

* [Creating guides](https://docs.nexthink.com/platform/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/creating-guides)
* [Managing guides](https://docs.nexthink.com/platform/user-guide/adopt/guide-creation-and-management-from-nexthink-applications/managing-guides)