Production and Staging Environments

This feature is only available for Growth and Enterprise plans.


Our new Staging environment will allow you to test Userpilot content in a separately from your Production environment. This will help you ensure that your content works perfectly without affecting your live environment.

Use Cases

  • Isolated testing. Ensure your content works perfectly without affecting your production environments.
  • Make changes and test new ideas without worrying about impacting your users.
  • Separated Analytics to distinguish between staging and production analytical data

Production token vs Staging token

To keep your Production environment separate from your Staging environment, you will only need to install each token on the corresponding environment.

Here’s how easy it is: simply use your Production Token for live content, and prefix your Staging Token with “STG-” when testing in the staging environment.

Below are the steps that you can follow:

  1. To find your tokens, navigate to this link or by clicking on the Configure menu on the bottom left and then clicking on Environment.

  1. If you already have Userpilot installed on your testing environment, simply copy the staging token and replace it your current token.
  2. If you are installing Userpilot for the first time, use the production token in the installation snippet for your production environment, and the staging token for your testing environment.
<script>window.userpilotSettings = {token: "STG-5rx54y"};</script>
<script src=""></script>

If you have Userpilot installed via Segment or Google Tag Manager scroll below for instructions.

Does the new Staging token affects the Userpilot installation?

Not at all! Your Userpilot installation will not be affected. The only difference now is that if you wish to install the Staging version of Userpilot on your staging environment, you will need to use the Staging token.

How do I view the data from each environment in Userpilot?

If you want to change the environment you are currently viewing in Userpilot, you can click on Production on the left menu, and then click on Environment. There you will be able to choose either Staging or Production.

How do I trigger content for one specific environment?

You can create content such as flows, spotlights, checklists, for example and test them in your staging environment before publishing it on your production environment.

To trigger content on a specific environment, simply go to its settings and select 'Staging Environment' under the Environment section.

Installing Staging Token via Segment

In order to install the staging token in your testing environment, you will need to create an additional Userpilot destination that is connected to a JavaScript source that is installed on your staging environment.

1) Once you create the destination that is linked to your staging source simply paste your token and enable the destination.

2) After clicking on Save changes you will then see both Userpilot destinations live.

For any questions or concerns please reach out to

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.