When defining an audience for your in-product prompt, you can choose whether you want to display the widget on every page of the selected website, or only on specific pages.
If you select specific pages to display the prompt, you’ll be asked to enter at least one path to your page — e.g. mywebsite.co/path
. To display the prompt across multiple pages, click the + Add page button and enter the respective URL path. You can add as many pages as needed.
You can also add URL patterns to dynamically match specific URLs. Learn more in the section below
URL patterns
Target all sub-pages within a path (wildcard)
Use an asterisk (*) to target all sub-pages within a path.
For instance, yourwebsite.co/pt-br/*
displays the prompt in all sub-pages under /pt-br.
Account for variables in your URL
If your URLs include variables, you can account for them using a colon (:) followed by the name your team has assigned to the variable. You may include as many variables as needed.
As an example, if you use variables named userid
and orderid
, you can enter something like yourwebsite.co/account/:userid
/orders/:orderid
/invoice to display the widget on each invoice page.
Hash navigation
It's possible to target specific pages containing a hash (#
). This is helpful if you need an anchor link to a particular section/heading directly.
If using hash navigation, the hash must come at the end of the URL. For instance: yourwebsite.co?darkmode=true
#app
URL parameters
You can also set up your prompt to be displayed only on pages with specific URL parameters, and pass on the data from variables to the maze results. This is helpful if you need to identify the page or the tester.
The parameter values can be hard-coded — in other words, the prompt will only show if the URL parameter matches a specific value. For instance, you can set up your prompt to target only people who come from a specific source (e.g. ?source=slack
), or only users who are seeing a specific experience on your website (e.g. ?darkmode=true
).
As a reminder, you can account for variables using a colon (:
) followed by the name of the variable.
For instance, ?version=:version
would display the prompt to all participants in a experiment, regardless of the version they’re seeing. This means that testers seeing yourwebsite.co/?version=b would see your prompt, as would testers who've been served ?version=a instead.
You can string together as many parameters as needed, like so: yourwebsite.co/?source=:source&category=toast&...
These variables are captured as custom metadata, and are visible on the Results page.
In the "versions" example, the maze results allow us to identify which version of the website the tester was on when they replied to the maze.
Learn more about tester metadata
Please note
- Parameter names and values are case-sensitive. That means that
parameter=a
will not be considered the same asparameter=A
- Any URL parameters that you define in a single target URL are not optional (i.e. aren’t AND/OR). This means that, if you add two or more parameters to a URL, the prompt will only be displayed if those parameters are all present. If you want to display the prompt in one URL or the other, click + Add page to set up multiple separate target URLs.
- Certain parameter names are reserved to be used by Maze. You can still use them to target testers, but they won't be captured as metadata in the results. These are:
browser
browserVersion
createdAt
duration
email
id
lang
model
os
startedAt
userId
vendor
Still need help?
If you have any questions or concerns, please let our Support team know — we'll be happy to help!