Overview

In this article, we will explain how UserGuiding’s algorithm works while checking redirect URLs and how you can optimize Redirection options for your onboarding materials.

Checking Targeting Conditions

When a Guide is triggered, UserGuiding's algorithm checks if a page's URL matches the previewed guide's Targeting conditions. This control prevents walkthroughs from triggering on the wrong page.

  • When the Targeting conditions match the current URL, the guide is being triggered without any problem.

  • When the Guide's Targeting conditions do not match the current URL, the end-user will be automatically redirected to the URL you have entered on the "Redirect URL" field on the guide's settings.

The latter case can only happen with the Custom Trigger Scenarios. Custom Trigger Scenarios are Guide List, Checklist, Resource Center, Permalink, and JS Trigger.

What happens when I turn Redirection Off?

If you do not want any automatic URL changes caused by the onboarding material activities, you can always turn Redirection OFF.

When it is OFF, there will be no Redirection (no URL change) when the targeting conditions do not match the current page URL. This also means the Guide will not function if those conditions do not match the current page URL.

How to adjust the Redirection Settings for a Guide

  • Log in to the Panel.

  • Navigate to the Guides tab.

  • Choose the Guide that you want to edit and visit its Settings Page.

  • Scroll Down, and under the Advanced Settings section, you will see the Redirection Settings.

The Redirection option for a Guide will be turned ON by default, and the Redirection URL will be the exact URL where you have created the first step of your Guide.

Example

When Guide A is triggered, the targeting condition will not match with the current URL, and the end-user will be automatically redirected to the URL https://userguiding.com/home to start the guide.

Redirection URLs with user-specific path

If your platform’s URL path is user-specific, you can add dynamic variables for the Redirection URLs.

To add them, you need to create custom attributes first. You can learn how to create custom attributes and send them to UserGuiding here.

Example

If you want to redirect your end-users to a dynamic URL that includes their user IDs, you can add these attributes in the URL as below.

In (i.e., https://sampleurl.com/{{user_id}}/menu), where “user_id” is a dynamic variable.


⚠️You will not be redirected to the correct URL (since it is dynamic) when you click on the “Open in Extension” shortcut button from the Panel. You need to go to the corresponding URL in your platform and then open the Chrome extension through the extension icon to preview the content.

Related Articles:

Why my guide does not show up?

Personalization, Displaying Dynamic Texts in the Onboarding Content

Did this answer your question?