FAQ: Regex and Page Settings

Learn to work with text strings and customize page settings to improve the delivery of your Userpilot flow.

How can I reset a flow for a specific user?

Reset a previously viewed flow for a certain user by calling userpilot.reset() from the console then doing a hard refresh.

You can find more info in the article Reset Flows Seen For a User in the Userpilot help docs.

Does Userpilot support wildcard characters?

Yes, you can include wildcard attributes for URLs and domains.

Here's an example.

To trigger a flow on the page Company.com/X/Y/:

Go to the Settings page for a flow.
Go to the PAGE heading and select Specific page.
Choose Matches all conditions + Matches Regex + Company.com + X/Y/*

Where can I find custom events on my dashboard?

First, you need to track an event by adding code or by using userpilot.track(). Then you'll be able to find the custom event in Users > Add Conditions > Custom Events in Userpilot’s dashboard.

When should I use “And” for conditions related to my flow?

Use "And" when you have two conditions that need to be met at the same time.

Let’s say you have two conditions. They are called A and B. You set the trigger for a certain flow only when A and B are met at the same time.

This means you want both conditions to be true in order to trigger a flow.

My page doesn’t refresh when moved from one URL To another.

Not refreshing is most likely because your application is a single page application (SPA).

Userpilot depends on page reloads (refresh) to update and trigger new flows. Thus, single-page applications do not reload after URL changes.

Your developer team must call userpilot.reload() every time the URL changes. We recommend reading, Installation Guide for Single Page Applications (SPAs) in the Developer section of Userpilot docs.

Can I vertically centralize a certain Modal?

No, the default centering for Modals is horizontal. This display produces better onboarding experiences on different screen sizes.

Why is my page not auto-scrolling to find the specified element?

This problem is most likely caused by Tooltip's Trigger tool setting. This setting controls the element's visibility.

Go to the website and then open the Flow Builder.
Open the Tooltip Settings panel and click the Individual tab.
Scroll down and click the Behavior heading.
Under "type", open the dropdown menu.
Select "Try to find element".
Click the X at the top of the panel.
Test the flow.

Why does my flow only trigger after forcing a refresh?

That problem likely happens because you are on a single page application. Userpilot depends on page reloads (refresh) to update and trigger new flows. Ask your developer team to call userpilot.reload() every time the URL is changed.

What happens if Userpilot refuses to connect to my page?

Here's what typically happens with a connection problem:

Userpilot sends data using a web-socket connection. Some networks block web-socket connections. The blockage is likely caused by a content security policy (CSP).

Here are two possible solutions:

Ask your engineering team to whitelist Userpilot on your domain.
Check our developer docs to understand what goes in and out of a client’s network.

What happens if a user closes the browser without engaging with the flow?

If a user does not engage with a flow during the first visit to a page, three things can happen:

the flow displays again when that user returns to the same page
the flow displays up to 3 more times (the first visit plus three more) if the user does not engage at all
if the user does not engage after a total of 4 visits, the flow is set to dismiss for that user (i.e. the user does not see it again)

Is it normal to encounter a small delay when there is a page change in my flow?

Yes, loading delays after a page change are normal. That's because flows are designed with two display features:

stop running after a page change
start running once a page is fully loaded

How can I navigate my users to a URL with a random ID and then continue the flow from there?

Let’s say your user is in flow A on page 1. You want the user to navigate to a URL with a random ID “https://X/Y/Z?id=ddc915-5ab3” and then continue to flow B on page 2.

Go to the Settings page for flow B.
Go to the PAGE heading and select Specific page.
Choose Matches all conditions + Matches Regex + https://X/Y/Z?id=*.

How can I trigger a flow on a page with a dynamic URL?

Let’s assume your dynamic URL changes from https://X/Y/0000, then to https://X/Y/0001, then to https://X/Y/0002, and so on.

To create that dynamic trigger:

Go to the Settings page of the flow.
Change the page trigger conditions to Matches Regex.
Add the dynamic element by entering a *. Thus, it would read Matches Regex https://X/Y/*

Can I use Userpilot UI patterns on browser pop ups?

No, Userpilot’s UI patterns can only be used on elements that are part of a page. UI patterns cannot be connected to a popup, which is part of the browser.

How can I keep triggering a flow until a certain goal has been met?

Locate the flow and then open the Settings page.
Scroll down to the FREQUENCY heading.
Select Keep triggering until the goal is met.
Select a goal section from the "Choose an existing goal" drop-down menu. Goals are used to specify if the user achieved the intended purpose of the flow like creating a campaign or adding team members.

Creating a new goal

Go to the Userpilot dashboard.
Expand the Growth Insights dropdown and click Goals.
Click Create Goal and give the goal a title. You can then click Add Conditions and use any combination of user attributes, auto properties, custom events, feature tags, etc. to form a goal which can be assigned to a flow.

How can I make users walkthrough flow 1, then be directed right into flow 2, then finally flow 3?

You can walk users through the flow by setting triggers.

Go to the second flow and open the Settings page.
Scroll down to the AUDIENCE heading.
Set the second flow to trigger after the first flow by selecting Engaged Experience or Completed Experience.
Repeat settings for the third flow. It triggers when the user engages with or completes the second flow.