On this page

For AI agents: a documentation index is available at /llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Reset an Experiment

Reset a Statsig experiment to return it to the unstarted state, generate a new salt, and run a fresh iteration without carrying over the previous run's results.

Resetting an experiment returns it to the unstarted state so you can fix a problem and run the test again. Statsig generates a new salt, creates new group IDs, clears the start and decision state, and starts a new analysis window. Reset an experiment when a bug or a bad variant invalidated the run and you want the same test to start over.

Use a different action when you don't need a fresh run:

  • To end the experiment without running it again, abandon it.
  • To turn off one bad variant while the rest of the experiment keeps running, disable that group.
  • To begin a new analysis window without re-randomizing anyone, restart results. A restart keeps the existing salt, so users keep their group assignments.

Reset an experiment

  1. Open the experiment and select the Make Decision dropdown.
  2. Select Reset.
  3. Start the experiment again after you fix the issue that prompted the reset.

What happens after you reset an experiment

  • The experiment returns to the unstarted state. Every user receives the default experience, either the value defined in code or the layer default, until you start the experiment again.
  • Statsig generates a new salt. Because the salt determines which group a user hashes into, users are randomly reassigned when you start the experiment again and don't necessarily land in the group they were in before. This reassignment keeps a bug or bad experience in the previous run from affecting the same group after you address the issue.
  • Statsig creates new group IDs and preserves each group's name and size.
  • Statsig clears the analysis window and saves a snapshot of the results collected so far.
  • You can archive the experiment after a reset to preserve its history and make it read-only.

Treat the new run as a separate experiment

A reset creates a new iteration rather than undoing the previous one, and Statsig can't restore an experiment to its pre-reset running state.

  • Results from the earlier run stay visible in the experiment's history, but don't combine them with the new run as a single scorecard. Mixing a pre-reset period with a post-reset period introduces assignment artifacts that bias the comparison.
  • Setting the salt back to its previous value doesn't resume the earlier run. It brings future assignment closer to the old hash mapping, but the analysis window has already restarted.
  • A reset doesn't restore allocation on an experiment whose allocation was set to zero. Raise allocation as a separate edit after you reset.

Was this helpful?