---
sourceDocument: Zurich ServiceNow AI Platform user interface
sourceDocumentLink: https://www.servicenow.com/docs/r/zurich/platform-user-interface
Release :
- zurich
ft:locale :
- en-US
ft:publication_title :
- Zurich ServiceNow AI Platform user interface
ft:clusterId :
- platux
bundleId :
- platux
workflow :
- Platform
---
# Create Guided Tours
# Create Guided Tours {#ariaid-title1}
* Release version: Zurich
*
* Updated July 31, 2025
*
*  4 minutes to read
After you outline the guided tour, use the Guided Tour Designer (GTD) to enter
the steps using callouts and triggers.
## Before you begin
Role required: guided_tour_admin or admin
## About this task
This task illustrates how to create a guided tour.
## Procedure
1. Navigate to AllGuided Tour DesignerCreate Tour. {#add-guided-tour__step_zxl_knh_4bb}
{#add-guided-tour__step_zxl_knh_4bb}
2. Enter the following information in the form:
{#add-guided-tour__table_ujy_ssw_ty__entry__2}
| Field | Description |
|:-|:-|
| Name | Enter a name for the tour that describes what the user accomplishes by completing the tour. |
| Tour Type | Select: * Standard UI for tours that start from system platform content, such as a list or a form. * Service Portal for tours that start from a Service Portal page. Note: When you select Service Portal, a Portal option appears, where you choose a record from the Service Portals table. * Custom UI for tours that start from Custom UI page. * Workspaces for tours that start from a Workspace page. {#add-guided-tour__ul_kwc_wnf_3db} |
| Starting Page | Select the page that the tour starts on: * If your tour type is Standard UI, your choices include pages that show lists and forms. * If your tour type is [Service Portal](https://www.servicenow.com/docs/XXmhuBEgxgX2e~FC3pcHpw "Service Portal allows you to build a mobile-friendly self-service portal experience for your employees or customers. Service Portal is a ServiceNow AI Platform feature that is active by default and interacts with parts of the platform so users can access platform features through portals."), your choices include [Service Portal](https://www.servicenow.com/docs/XXmhuBEgxgX2e~FC3pcHpw "Service Portal allows you to build a mobile-friendly self-service portal experience for your employees or customers. Service Portal is a ServiceNow AI Platform feature that is active by default and interacts with parts of the platform so users can access platform features through portals.") pages. Note: In the base system, you can only launch tours from pages that use the SP Header Menu. Manually launched tours do not display on pages with custom header menus. * If your tour type is Custom UI, your choices include pages that show Custom UI pages. * If your tour type is Workspace, your choices include pages that show Workspaces pages. You can select the page in two ways: * Paste URL: You can copy the URL of the workspace page and paste it. If the URL isn't a valid experience, the Create Tour button isn't enabled. Important: The maximum length for URLs is 2,500 characters. If a URL exceeds this limit, it is automatically truncated to the first 2,500 characters. * Manual Selection: You can select the page from the drop-down menu by entering the name of the page. Note: If the selected page contains parameters, you must mention the values of the parameters. If you want the tour to apply to the same page without exact parameters, configure the page parameters as dynamic. You can begin entering the UI page name to show a list of matching pages, and then select it from the list. {#add-guided-tour__ul_dg2_35w_fyb} {#add-guided-tour__ul_pqv_psf_3db} Note: In some cases, navigating to standard forms and lists while creating custom tours might not work as expected. You can choose the following workaround to create the custom UI tour in such cases: 1. Create standard UI type tour on any page, ideally home page. 2. Go to system property - com.snc.guided_tours.homepages and add the name of the custom page in the Value field of this page. You can enter multiple values separated by commas. 3. Update the context of the tour from form view to your custom page. {#add-guided-tour__ol_kl5_s2v_smb} |
| Roles | * If the tour can be accessed by all the roles, then select All. * If the tour can be accessed by specific roles, then select Specific. Select the roles that can access the guided tour and move them from the Available Roles list to the Roles that can view the tour list. {#add-guided-tour__ul_dz1_rn5_xfb} Note: When you add at least one role to a tour, it limits the audience to only those users who have that role. |
[ ]
{#add-guided-tour__table_ujy_ssw_ty}
3. Select Create.
The Guided Tour Designer opens in draft status in a new tab or window.
4. Select Create Introduction.
1. Enter an introductory title for your guided tour.
2. Write a message to your end users explaining the purpose of the tour.
3. Select Save.
{#add-guided-tour__substeps_ilm_dwb_xdb}
5. Follow these steps to add a tour step with a callout and trigger:
1. Drag a callout from the upper right corner of the screen and drop it on top of the UI element.
The element is highlighted when the callout is positioned correctly. When you release the callout, it locks into the position.
2. Enter the instructions in the Text box.
You can change the direction of the callout by selecting the correct option under Placement. Only the placement options applicable to the selected element are enabled.
3. [Select the trigger](https://www.servicenow.com/docs/jvR0y1ejtHKZ9Je1KyyPIA "Triggers are actions that you take to move the tour to the next step. Each callout in a guided tour step has a specific trigger that activates the subsequent step. You define the trigger for each callout, and only relevant triggers appear based on the UI element referenced by the callout.") from the Choose action list. Only triggers applicable to the selected element appears in the list.
{#add-guided-tour__ph_ejg_cth_4bb}
4. **Optional:** To format text, such as bold or italic, add HTML tags around the text.
For example, enter Click <b>New</b> to set up a delegate. You can add other HTML tags, including tags for images.
5. **Optional:** Select the Skippable check box if a user can skip the step and proceed to the next if an element or field is unavailable at runtime.
6. Select Save.
The first Step label appears.
When your end users select the label, they see your first step instructions rendered as a message.
{#add-guided-tour__substeps_khb_yyx_ty}
6. Continue adding steps until you have completed the tour.
The tour is saved as you save each step. {#add-guided-tour__step_p12_yth_4bb}
{#add-guided-tour__step_p12_yth_4bb}
7. Select Create Conclusion.
1. Enter a closing message for the demo that summarizes the users' achievements.
2. Select Save.
{#add-guided-tour__substeps_ggc_b1f_bgc}
Note:
You can edit and delete introductions, conclusions, and callouts at any time while your tour is in draft status. You can also insert HTML markup into your conclusions, introductions, and callouts.
All standard HTML
tags compatible with your browser are supported.
8. Select Preview at any time to test your steps and make any final revisions to the tour.
Note the steps that aren't working properly or that need correction. Edit the tour or the steps as described in [Edit Guided Tours](https://www.servicenow.com/docs/R~O_K1gngJykeBjZ2qZTsw "You can modify the settings of a guided tour by using the Guided Tour Designer (GTD).").
9. To share your draft or published tour with your internal colleagues for review, do the following:
1. Select the copy URL icon to copy the tour URL.
2. Send the URL to reviewers.
{#add-guided-tour__substeps_fyc_sth_zdb}
10. Select Publish to make your guided tour visible to users.
## Result
The guided tour is created and listed in the Help Center. Each guided tour is allotted with a unique tour ID. If you set property (com.snc.guided_tours.sort) to true, the tours appear in alphabetical order.
**Related concepts**
* [Exploring Guided Tours](https://www.servicenow.com/docs/HC78~gtSDXznTyzNxAQgPw "Discover the components of Guided Tours and learn how to create and utilize guided tours to familiarize new users with the features and processes of the ServiceNow AI Platform.")
*[\>]: and then