# Creating a new Tour

## Creating a new guide

1. Sign in to the Adopt Management Console with your credentials
2. Click on the name of the Space you want to work on
3. Click **Guides** from the menu pane on the left
4. Click **Create Guide** in the top right corner of the screen&#x20;

You will be given two options to choose from.&#x20;

* **Tooltip -** one guide
* **Tour -** a sequence of guides

<figure><img src="https://3373275186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTixy2PVhBMrIReEVJzTb%2Fuploads%2FRhxhaMFYzMDKKgKvlCom%2Fimage.png?alt=media&#x26;token=60a1561b-d5d9-4748-a301-369c533d238a" alt=""><figcaption></figcaption></figure>

5. From the Create Guide button, select **Tour**
6. Name the Guide
7. Provide an initial URL

***Note:** This URL will be used to navigate to the application where you can start modifying your guide in **editor mode**.*

***Note:** We recommend you add a brief description for your future reference. This will come in handy to keep track of the guides as you add more to cover all the journeys that a user might take in your application.*

8. Once you have filled the information in, click **Create.**

<figure><img src="https://3373275186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTixy2PVhBMrIReEVJzTb%2Fuploads%2FdNkJEzKrf9xJXcWPycAA%2FPicture2.png?alt=media&#x26;token=9ef070eb-bc61-435f-8a1c-86b202b65bba" alt=""><figcaption></figcaption></figure>

The created guide will now sit here:

<figure><img src="https://3373275186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTixy2PVhBMrIReEVJzTb%2Fuploads%2Fcsh2vvpEBypuyorljlVX%2FPicture3.png?alt=media&#x26;token=7102d447-4967-43d3-b394-e7062095f2ad" alt=""><figcaption></figcaption></figure>

Now that you have created a new guide, either repeat the process to create other guides for different parts of your application, or add steps to the guide and define its parameters.

Click **Open in Editor** and you will be redirected to the Adopt Editor where you can modify your guide with many personalization settings provided.

<figure><img src="https://3373275186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTixy2PVhBMrIReEVJzTb%2Fuploads%2FriWcMzGIVXSUMSJdjUlf%2FPicture4.png?alt=media&#x26;token=31dd5f3d-b4e2-4b9d-bff9-bf5170fd17b3" alt=""><figcaption></figcaption></figure>

***Note:** At this stage, newly created guides do not have any steps, meaning the guide does not yet know where to start or what the next step is.*

## Adding a step

1. Open your chosen guide in the Adopt Editor
2. Click **Add a Step**, or alternatively click the **+** icon

<figure><img src="https://3373275186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTixy2PVhBMrIReEVJzTb%2Fuploads%2Fw9gVIUR0gtXDvScN2Vv2%2Fimage.png?alt=media&#x26;token=86db92e2-d67a-4640-9175-3ef78ffa3a79" alt=""><figcaption></figcaption></figure>

3. Click **Step** from the dropdown, or use the keyboard shortcut **Shift + A** \
   \&#xNAN;***Note**: This will activate the element picker where you can choose an element on the page to associate to this step*
4. Either hover the cursor over your page and choose an element by clicking on it, or using the **Shift + S** keyboard shortcut. This will create a step assigned to the chosen element \
   \&#xNAN;***Note: Shift + S** keyboard shortcut is handy, especially when an element can’t be chosen by a mouse. This may happen when you want to pick an element in a pop-up menu which isn’t visible when clicked. In such cases, you can use the keyboard shortcut.*

Now that you have created a new guide and added a new step, you can add as many as necessary to cover every possible scenario where a user might need guidance.&#x20;

You can also customize the Step by clicking on the gear icon of the step.

<figure><img src="https://3373275186-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTixy2PVhBMrIReEVJzTb%2Fuploads%2FiMWMqc4K2VWon9EPmBnE%2Fimage.png?alt=media&#x26;token=9d5912e6-3db2-4ac1-932b-1cc8c160f36e" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-adopt.nexthink.com/in-application-guidance/creating-and-managing-tours/creating-a-new-tour.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
