Restore a snapshot
Outcome You replace the Current State of an instance with the contents of a snapshot - fully, partially, or to a different target.
Before you start
You hold the Instance Editor role in the target instance (Viewers can read snapshots but cannot restore from them).
The snapshot you want to restore from is available in the timeline.
You have decided whether to restore to the same instance, to a different Instance, or only specific items.
Restoring a snapshot replaces the Current State of an instance with the contents of the snapshot. If you don't have Editor rights on the target instance, ask an Instance Editor to either restore for you or distribute the snapshot to your instance.
Restore to the same instance
The most common case - bring this Instance back to a previous state.
Navigate to the space containing the instance.
Navigate to the instance.
Open the snapshot timeline view by hovering over the camera icon on the sidebar and clicking SNAPSHOTS.
Identify the snapshot you want to restore.
Click Reset to current instance under Actions.
Confirm the operation.
Restore to a different instance
Use this when you want a fresh instance pre-populated with a known-good state - for example, when onboarding a new team member or spawning a parallel exploration.
The limitation: the target instance has to be in the same space as the snapshot. If you need to restore to a different space, use the partial restore technique below, which uses distribution.
Navigate to the space containing the source instance.
Navigate to the Instance that holds the snapshot.
Open the snapshot timeline view by hovering over the camera icon on the sidebar and clicking SNAPSHOTS.
Identify the snapshot you want to restore to somewhere else.
Click Reset to another instance under Actions.
Select the target instance - you must be an Instance Editor of the target, and the target must be in the same space.
Confirm the operation.
Partially restore from a snapshot
You can selectively recover specific files, tables, or applications from a snapshot without overwriting the entire Current State. This uses the distribution feature, and unlike full restore, can target an instance in a different space.
Navigate to the space containing the instance.
Navigate to the instance that holds the snapshot.
Open the timeline view of snapshots and click the snapshot name to open it.
Stage the objects (files, tables, or applications) you want to restore.
Open the distribution flow and select the target instance - this can be the same instance, or any instance you have Editor access to (including in other spaces).
Select the Overwrite distribution strategy.
Complete the distribution.
The selected objects in the target instance's Current State are replaced with the versions from the snapshot. Other files in the target instance are left alone.
For the full distribution mechanic and all four distribution strategies, see Reference › Configuration.
Role-specific notes
In archived courses, restoring a snapshot to the Current State gives you a 3-day grace period to access the data before the instance is re-archived automatically. You can repeat the restore as many times as needed. See How-to › For Students › Work with an archived course for the full lifecycle.
Restoring a named vintage snapshot is the canonical way to begin a reproduction attempt. See Tutorials › For Researchers › Reproducing a colleague's research project for the full reproduction workflow including verification.
Last updated
Was this helpful?