Manage history and versions
History allows you to track changes made to your notebooks and restore them to previously recorded states. It supports two types of checkpoints:
Default checkpoints are created automatically for key events such as notebook creation, adding or deleting sheets, or deleting cells.
Custom checkpoints are created manually by the notebook owner or users with edit permissions.
If Git backup is configured in your workspace, you can also push changes to a Git repository when creating a checkpoint manually.
All users who can view the notebook can also view its history, but only users with edit permissions can revert it to a previous state or delete checkpoints.
View history
Select from the main menu.
In the History tool, view notebook states by selecting checkpoints from the list.
(Optional) You can choose between the two viewer types and select whether you want to see the unchanged cells.
Revert to a state
Open the History tool.
Select the checkpoint for the required state. The revert icon will appear for the selected list item.
Click the revert icon.
Click OK in the Confirmation dialog to finish the procedure.
A new checkpoint is added to the top of the list under the name Revert to [selected_checkpoint].
Add a checkpoint
Add custom checkpoints to save specific notebook states to its history.
From the main menu, select .
In the Enter checkpoint message dialog, provide a description for your checkpoint.
(Optional) If you have workspace backups configured and want to add the checkpoint to the Git repository, enable Commit and push to Git repository.
Click Add checkpoint....
Download a checkpoint
You can download the notebook version at any checkpoint as a .ipynb file.
In the main menu, select .
In the timeline, find the version you want to download and click Download next to it.
You can import the downloaded file and create a new notebook from it.
Delete a checkpoint
To delete a checkpoint from history:
In the main menu, select .
In the timeline, find the checkpoint you want to delete.
Click
(Delete checkpoint) next to it and follow the prompts.
Keywords
versioning, notebook version, notebook history