# Simple product tours

### Video tutorial

The below video tutorial demonstrates how to create a simple product tour:

{% embed url="<https://www.youtube.com/watch?v=CfML_PSC9Gc>" %}

### Instructions

* Add the 'ProductTour' element to the page of your Bubble app where you're running the tour

<figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2F9Lhdid5KTzJVgHpWRDK3%2F2024-01-29%2010.09.37.gif?alt=media&#x26;token=c4c718b1-9667-44ea-956e-9462308d81c1" alt=""><figcaption></figcaption></figure>

Please note that you must keep the **'This element is visible on page load**' option ticked. Don't worry though, even with this option ticked, the element will not actually show up on your users screen.

* Add an ID attribute to the elements you want to highlight during the product tour. In this example I've added the ID attribute 'step1' to a repeating group I want to highlight

<figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2F9d4XrEGoqctw2dtygUVT%2FScreenshot%202024-01-31%20at%2012.04.37.png?alt=media&#x26;token=3044b1c9-3b1c-4c02-ab37-2047bc226b3c" alt=""><figcaption></figcaption></figure>

* Add a workflow for 'When page is loaded'
  * Add a 'Add a step in Product Tour' action to this workflow and add the ID Attribute you put on the element you're highlighting in the 'Element ID' field&#x20;

<div align="left"><figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2FT5PDyJU5RbrAS3D0UZxW%2FScreenshot%202024-01-31%20at%2015.18.14.png?alt=media&#x26;token=3f48d09f-4daf-42a6-8952-7f07b655d905" alt="" width="375"><figcaption></figcaption></figure></div>

* Repeat this for each step in your tour (in the example below I'm adding 4 steps to the tour)

<div align="left"><figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2FDSD8jhFHxIJvbpUqbnQs%2FScreenshot%202024-01-31%20at%2012.12.49.png?alt=media&#x26;token=46a2d898-cba6-4b7a-8917-7c88a56b9a7d" alt="" width="563"><figcaption></figcaption></figure></div>

* After you've added all the steps you require, add a 'Start ProductTour' action to the end of your workflow

<div align="left"><figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2FnlVqFWix5ZACjvUn0sQ4%2FScreenshot%202024-01-31%20at%2012.16.13.png?alt=media&#x26;token=f00dedf6-6916-44d0-abe5-859d00251553" alt="" width="563"><figcaption></figcaption></figure></div>

Now when the page is loaded, the plugin will 1) add the steps to the tour and 2) start the tour.

<figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2FJwdtw7nTYjCIfjkLuiCD%2F2024-01-31%2012.24.37.gif?alt=media&#x26;token=4e81e1e0-188d-421d-a395-d92ed5324bcb" alt=""><figcaption></figcaption></figure>

* If you want to add an **introductory step** that isn't attached to any specific element, you can simply add a step to the start of the tour and not add any Element ID

<div align="left"><figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2FBiXVYdfEgJfpONi46ORH%2FScreenshot%202024-01-31%20at%2012.30.17.png?alt=media&#x26;token=ae767358-12f7-44c1-927f-ad4fe32ce566" alt="" width="563"><figcaption></figcaption></figure></div>

* You'll then get a step that appears in the middle of the screen and isn't attached to any 1 element:

<figure><img src="https://3779964754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fofqy66xyJ0E2i4hRedIQ%2Fuploads%2FSZYjxIC4oAphW9MFtpWF%2FScreenshot%202024-01-31%20at%2012.32.47.png?alt=media&#x26;token=05fad701-28b5-4bfb-a4d6-5d1eb15de6e4" alt=""><figcaption></figcaption></figure>

### Demo app

You can view a demo app with a simple tour at the below link:

{% embed url="<https://product-demo-tour.bubbleapps.io/>" %}

The editor is public and can be accessed by clicking on the 'editor' button in the sidebar nav.
