You're looking at an older version of Totara.

Please see Totara 15 help for the latest version.

On this page

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space THM and version 13


For example, when onboarding new users to your site it is important to make sure they are comfortable with navigation and how to find the information they need. This can be tedious and logistically challenging, especially in larger organisations and those whose employees are geographically dispersed. The Tours user tours feature allows you to setup an initial automated walk-through for orientation.


Widget Connector

(The video above is taken from the Dashboards and basic theming course in the Totara Academy).


A Site Administrator, or another role with the Create, edit, and remove user tours (tool/usertours:managetours) capability, can set up the User Tourtour by following these steps:

  1. From the quick-access menu go to Development > Experimental > User tours.
  2. Click on Create a new tour
  3. Give the tour a Name and optional Description.
  4. Enter the details of where and who the tour is for, then URL of the page(s) to which you want to add the tour in the Apply to URL match field.
  5. Check Tour is enabled, then optionally configure the other settings.
  6. Optionally configure a range of Tour filters:
    • Category: Show the tour on a page associated with a course in the selected category.
    • Courses: Show the tour on a page associated with a course.
    • Course format: Show the tour on a page associated with courses using the selected course format.
    • Role: Limit the tour to only show to users of a certain role. For example you could just show a tour to Site Administrators to explain new features.
    • Theme: Only display the tour when a specific theme is used.
  7. When you have finished, click the Save changes button. 
  8. This will take you back to the list of tours; click on the name of your new tour to start creating steps.
  9. Next click New step to add your first step. 
  10. Fill out the details of that step (e.g. location and content) then . See the Step targets section for more information on selecting the location for each step.
  11. When you are done click Save changes
  12. Repeat sets 5 and 6 until you have completed your tour.until you have added all steps in the tour.

Step targets

When creating a step in a user tour you can decide which feature to highlight using the settings in the Step target section.

First select the Target type from the following options:

  • Block: This option allows you to select a block type from the Block dropdown list. If a block of this type is present on the selected page it will be highlighted.
  • Selector: Highlight part of the page using the selector from an element's CSS code. Find out more below.
  • Display in middle of page: This option displays the step as a pop-up in the middle of the page. This can be useful for introductions or general guidance that isn't specific to a block or layout element.

If the element you want to highlight isn't a block you will need to use the Selector option. These steps will outline how to find the relevant CSS in Google Chrome, but the method may be different in other web browsers. Follow these steps to find the selector:

  1. Navigate to the page containing the element you wish to highlight in Google Chrome.
  2. Press Ctrl+ Shift + I to open the Developer tools. Alternatively open the menu and go to More tools > Developer tools.
  3. Click the inspect element icon (Image Added) or press Ctrl + Shift + C.
  4. In Totara select an element (e.g. the navigation bar or a button) and a section of CSS code will be highlighted in the Elements window of the Developer tools panel.
  5. With the code selected, click the ellipse icon next to it, then Copy > Copy selector.
  6. Paste the selector (which should look something like '#yui_3_17_2_1_1610030264859_192') into the CSS selector field for the user tour step.
  7. Test the user tour to ensure that the step points to the correct element.

Finalising your user tour

When you've created all of your steps your tour is ready. If you've not enabled it already, enable it (by going into the tour settings) to make it active.

Example of the user tours feature.Image RemovedThe first step of a user tour.Image Added

Now you can browse to where your tour starts and experience it.


There is a Reset user tour on this page link in the footer than can be used to re-experience a tour.

Alternatively you can navigate Quick-access menu > Development > Experimental > User tours and select a tour, then click force the tour to be displayed again. All users will then see the tour when they next visit the relevant page.

Manage tours

After you have setup at least one tour you will be able to manage your existing user tours by going to Quick-access menu > Development > Experimental > User tours.


  • Enable/disable the tour (eye icon)
  • Edit the settings (cog)
  • Export the tour (up arrow)
  • Delete the tour (cross)

Managing user tours.Image RemovedManaging user tours.Image Added

Import a tour

You may wish to import a user tour (perhaps if you have multiple Totara sites), this can be done from the user tours management interface. Before you can import you will need an exported tour file, which will have the extension .json.