Some of our widgets come with a URL filters parameter. This setting allows you to define the set of pages where you want to show (or hide) a specific widget. Here are some common recipes:
1. Show on one page
The widget appears when the page URL is exactly https://example.com
2. Show on multiple pages
The widget appears when the page URL is either https://example.com/page1 or https://example.com/page2
3. Show everywhere but one page
The widget appears on all pages except when the page URL is exactly https://example.com/page1
4. Show everywhere but multiple pages
The widget appear on all pages except when the page URL is either https://example.com/page1 or https://example.com/page2
5. Relative paths
If your app is available on multiple domains and/or environments, use relative paths instead of full URLs. With the example above, the widget will appear at mydomain1.com/page1 and also at mydomain2.com/page1.
6. Wildcard URLs
Use wildcard URLs to target a broader set of pages. With the example above, the widget appears when the page URL starts with https://example.com/path/. For example, it will appear at https://example.com/path/page1 and https://example.com/path/page2 and https://example.com/path/page3.
7. Query strings
A common way to trigger the prompt in your workflows is to add a specific query string to the current page URL. For example, with the above configuration, the widget appears only when the current page has a ?show-widget=true query string in its URL. Add that query string to the page URL in your code to trigger the widget.
8. Combined filters
You can combine all the previous examples to create a more complex set of rules with both negative and positive filters. For example, here the widget shows only when the page URL starts with https://example.com/path/, except if it has a ?nobanner=true query string in its URL.
9. Invalid example
When a positive and negative filter are in conflict, the negative filter wins. The example above instructs the widget to only show at https://example.com/path/page1 except when the page URL starts with https://example.com/path/. In this case, the widget will simply show nowhere.