Skip to main content

How to add a Product Tour to Confluence

How to easily add a product guide to your Confluence page?


This quick guide describes how to do it even without administrative rights.




1. Get your Usetiful code

Log in to your account on Usetiful.com and click the "Embed code" button. The code will show up in the modal dialog. Copy it to the clipboard (select the code and press Ctrl+C).



2. Paste the code into HTML macro

Edit or Create new page on Confluence, where the tour should show up. When in Confluence editor, choose from the toolbas the option  "Insert more content" and select the option "Other macros" at the bottom of the list. Search for the "HTML" in the displayed modal dialog.


Add the HTML macro into the page and paste the Usetiful code inside.


Save the page.

3. Configure the tour

If you don't have a product tour created - you can create new one in Usetiful! Here are few tips & tricks. Tour will show up automatically, if parameters "Autoplay" or "Usetiful button" are enabled.


When setting up the tour, important is the "Url" field that specifies on which pages the tour will display. Paste the domain of your Confluence and click "Save".

Return to your Confluence page and refresh it using the Ctrl+F5 keys.

4. Enjoy the tour!

Don't forget to track usage of your product tour with Usetiful reports ;)
Related:

Popular posts from this blog

Hotspots and their purpose in user onboarding

When done well, Hotspots can help with user onboarding by quickly highlighting features or functions.
Read more

Select Element on Your Page

  To associate tour steps (pointers) with specific elements on your site, you need to hook to the selectors of elements. Selectors are used to "find" the HTML elements on your site. It is not difficult to find out the selector of a specific page element. The easiest way is to use our Chrome extension . Usetiful for Chrome extension (Recommended) 1. We recommend you to first install  the extension  - it enables you to preview product tours directly on your page without embedding the code. When on the page, it allows you to get the element selector on just one click.   2. Inside the tour editor, the " Element"  field require you to enter the selector of the HTML element on your site. Click on the  "Select element"  action on the right side of the field.  The following dialog will appear if the Usetiful browser extension is enabled. 3. Enter the address of your web page and click "Open page" 4. To select the...
Read more

Alternatives to Shepherd: Which One Is Right for You?

  Shepherd is a popular open-source tool for building product tours. However, there are better options to meet the demands of modern onboarding. Here are some great alternatives that can help boost user adoption. What is Shepherd? Shepherd is a JavaScript library. It was built to help onboard new users with product walkthroughs. It's a flexible tool that allows you to drop product tours into your app using popular languages like: Angular Ember ES Modules Vue.js  Javascript Shepherd comes with a few default themes, but its primary selling point is that it allows you to customize your tours.  The problems with Shepherd as an onboarding tool We're not here to rip Shepherd. It's a good tool that does what it sets out to do. However, it falls short of a great modern onboarding tool for several reasons. #1. Limited accessibility Shepherd is relatively easy to use if you have good technical knowledge. However, you're out of luck if you don't know how to code. In an era whe...
Read more