Targeting Spotlights

Now that everything is set up, it's time to publish your spotlight live! After you have previewed the spotlight that you created in the chrome extension builder and you're ready to see it live, click on the "Publish" button from the builder. You will be navigated to the Userpilot web app to set up the targeting settings for your spotlight.

To ensure that the spotlight will be only displayed for the relevant users and in the right place within your app, you can specify the targeting configurations based on Domains, Pages, and Audience. These targeting options can give you more power in controlling and delivering the best customer experience.

Domain Targeting

If you would like to test on a staging domain before deploying it to production, you can control which domain or subdomain you would like to trigger the spotlight on.
Note: You will need to install the Userpilot snippet in order to see content live


  • All domains ( Default): Displays the flow anywhere the Userpilot script is installed
  • Specific domains: Displays the flow if the domain exactly matches the input string 

Note: You can list all the domains that you have Userpilot installed on the the Environments tab to automatically find the domains listed in the drop down.

Use Wildcards to match dynamic domains

In many cases, your domain might have dynamic parts that change from user to user.  A common use of a wildcard domain is with applications that use a personalized subdomain for each user or account.

You can easily use the Asterix symbol as a wildcard (*) to replace the part that is dynamic/changing. For example, to show the flow on '' where the part 'name' is dynamic. You can set the domain to be the following:

Page Targeting

This section will allow you to specify the pages you would like show the Spotlight in your web app based on the URL the user is on.


  • Any page (Default): This will show the spotlght on any page that has the Userpilot script installed
  • Specific page: Here you can limit the spotlght to be shown on specific URL path(s) within your web app. 

You can add one or multiple conditions of a URL path. An example is if you would like the spotlight to appear if the user is on one of two specific pages. In that case, you can add a condition with each URL path specified and select the option" Match any conditions".


What if my URL contains dynamic URL paths?

In the case of dynamic URL paths, you can select the page condition "Match Regex" and replace any dynamic part of a URL with an asterisk.

Audience Targeting 

This section defines how you can differentiate which users are eligible to see your spotlight. 
Based on user or company data and product usage data, you might want to target spotlights to a specific cohort of your users - e.g. you might want to target a spotlight based on the specific role of the user or you might want to target it only to users who didn't invite a teammate. 


  • All users (Default):  Any identified user is eligible to see the spotlight
  • Only me (useful for testing): All users who have access to your Userpilot account and have the chrome extension builder installed. 
  • Specific segment: Use a previously created Segment that targets a specific group of users. This can be useful when you have a saved criterion that you want to use multiple times in several flows.
  • Users that match specific conditions: Define a subset of your users by using a set of rules to dictate which users are eligible to see the spotlight. This includes user and company data that you are passing through your snippet, auto-properties that Userpilot automatically collects, events and actions that your users achieve in your app, and many more.
Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.