All Apps and Add-ons

auto run splunk tour

renems
Communicator

I made a nice splunk tour. Only thing I'd like to accomplish, is to have it started automatically for all of our splunk users. Somehow I can't get it done. Not much documentation to fall back upon.

How do I have my product tour to auto-start?

I'm aware that you can run it by adding "?tour=" to a dashboard, but that makes it essential to run that dashboard. I'd prefer a solution where it just pops up, kind of like the product tour splunk by default brings to the table.

1 Solution

ebond_splunk
Splunk Employee
Splunk Employee

Hi @renems

To make a tour auto start, all you have to do is name the tour the same id(name) of the dashboard/view with "-tour" appended to it.
For example:
If you have a dashboard named "Foo Dashboard", Splunk will give it the id of "foo_dashboard" and it's accessed by the url "app/search/foo_dashboard"... if you name the tour "foo_dashboard-tour", it will automatically pop up a request to take the tour.

so the tour in etc/system/local/ui-tour.conf would look like this:

[foo_dashboard-tour]
....

NOTE: Once the user takes the tour or skips it from the dialog, an attribute is set on that tour that it has been viewed and the auto popup will no longer happen. To override this and have the tour prompt happen each time, you need to set an attribute of "viewed = 0" to the tour.

Hope this helps! If you need anymore detailed help, drop me an email.

View solution in original post

renems
Communicator

Thank you Eric, this was exactly what I was looking for!

0 Karma

renems
Communicator

I also noticed that the text in the pop-up is customizable by using "intro = some text" in the ui-tour.conf. Thought I'd mention this for others who stumble into this issue.

ebond_splunk
Splunk Employee
Splunk Employee

Yep! good catch.

0 Karma

ebond_splunk
Splunk Employee
Splunk Employee

Hi @renems

To make a tour auto start, all you have to do is name the tour the same id(name) of the dashboard/view with "-tour" appended to it.
For example:
If you have a dashboard named "Foo Dashboard", Splunk will give it the id of "foo_dashboard" and it's accessed by the url "app/search/foo_dashboard"... if you name the tour "foo_dashboard-tour", it will automatically pop up a request to take the tour.

so the tour in etc/system/local/ui-tour.conf would look like this:

[foo_dashboard-tour]
....

NOTE: Once the user takes the tour or skips it from the dialog, an attribute is set on that tour that it has been viewed and the auto popup will no longer happen. To override this and have the tour prompt happen each time, you need to set an attribute of "viewed = 0" to the tour.

Hope this helps! If you need anymore detailed help, drop me an email.

ejahnke
Explorer

Is this still applicable? It doesn't seem to work in my case. I appended the "-tour" suffix to the ID of the dashboard, but it doens't start when I view the dashboard. (Tried it with a test user)

0 Karma
Got questions? Get answers!

Join the Splunk Community Slack to learn, troubleshoot, and make connections with fellow Splunk practitioners in real time!

Meet up IRL or virtually!

Join Splunk User Groups to connect and learn in-person by region or remotely by topic or industry.

Get Updates on the Splunk Community!

Index This | What travels the world but is also stuck in place?

April 2026 Edition  Hayyy Splunk Education Enthusiasts and the Eternally Curious!   We’re back with this ...

Discover New Use Cases: Unlock Greater Value from Your Existing Splunk Data

Realizing the full potential of your Splunk investment requires more than just understanding current usage; it ...

Continue Your Journey: Join Session 2 of the Data Management and Federation Bootcamp ...

As data volumes continue to grow and environments become more distributed, managing and optimizing data ...