Starting Tours

HelpHero Tours can be started in any combination of the following ways:

Auto Start

Tours that have auto start enabled will begin automatically when a user visits a matching URL and they have not previously viewed the tour. This is useful for welcome tours or explaining new functionality. You can enable this setting per tour from the HelpHero editor.

What happens if more than one tour is eligible to auto start?If there is more than one tour eligible to be auto started from the page the user is currently on, then the higher priority tour starts and the other tour will start on their next visit to that page or page refresh. This behaviour is intended to prevent the user being overwhelmed with tours. You can prioritise tours with drag and drop in the HelpHero Editor.

Checklists

You can add your tours to checklists to provide your users with a structured way to learn and get started with your application. To learn more head over to the checklists docs

You can share a link to a particular tour. This is great for initiating your tours from outside of your app. For example by using a link your tours can be included in emails, your documentation or in chat apps. Links are also a great way to test tours by sharing them with your colleagues before enabling them for your users. Tours can always be started from a link regardless of how auto start and on demand are configured. Need to setup tour links for more advanced scenarios like wildcard domains or query strings? Head over to the tour links docs

Intercom Messenger

If you are using Intercom you can display your tours from both the Intercom Messenger Home and Intercom Messenger Conversations. Learn more about integrating with Intercom

Javascript API

Tours can be started from your own code via the HelpHero Javascript API. This is useful for more advanced use cases where you need greater control of when tours start. For example you may want to start a tour on a click to a particular element for example:

<button type="button" onclick="HelpHero.startTour('<TOUR_ID>')">Start Tour</button>

Or you may want to start tours in respond to an event in your system. Tours can always be started from the Javascript API regardless of how auto start and on demand are configured.

Where do I find the ID of a Tour?

If you want to start a Tour via the Javascript API you will need it's ID. You can get the tour ID of any tour you create from the HelpHero Editor.