Notebook Version History

Note

This is a Preview feature.

The Version History feature allows users to view and compare visual differences between two Notebook versions. It provides a Git-like experience directly within the Notebook interface. This feature displays a chronological list of all saved versions with timestamps, which makes it easy to track a Notebook's evolution. By visually highlighting changes, Version History reduces the risk of data loss and eliminates the need for manual version management, such as duplicating Notebooks at various stages. It streamlines version tracking and simplifies understanding the Notebook's development over time.

View the Notebook Version History

To view the version history in the Notebook, select the Version History button.

An image that shows the "Version History" icon within a Notebook.

Compare Versions

By default, the Compare Versions toggle is on. To compare two versions, toggle on Compare Versions and select the versions you want to compare. When you toggle off Compare Versions, you can view the selected version on the right side of the panel in its complete Notebook format, including the outputs.

An image that shows the "Compare Versions" toggle selected, and the Notebook version dropdown being used to compare two Notebook versions.

The side-by-side visual differences are displayed between the two versions. You can also view the versions with timestamps in the Version History (right navigation) pane. In the version selection list, the Current option shows the last saved Notebook contents, while the Version History pane shows the most recently created version from the version history. These versions are not the same, as new versions are created every 2 minutes.

An image that shows the Version History pane, which lists saved Notebook versions.

Version Retention Policy

  • A new version is created when changes are made and two minutes have passed since the previous version was created.

  • All versions created on the current day are retained.

  • For versions created on previous days, only the oldest version for each day is retained, up to a maximum of 30 days.

  • Versions older than 30 days are not retained.

  • To preserve a specific version, SingleStore recommends adding it to your favorites list on the day you create the version.

Note

New versions are auto-created only when changes occur.

Manage Versions

You can view details, edit details, add to favorites, remove from favorites, duplicate, restore, and delete a version of the Notebook in the Version History pane.

View Version Details

To view the details of a version of the Notebook, select the version name/timestamp of the version in the Version History pane. Alternatively, you can select the ellipsis (three dots) in the selected version, and select View Details. You can view the version name, the name of the user who created it, the timestamp of its creation, and the description.

An image that shows Notebook version details, including who created it, when it was created, and a description of the version.

Edit Version Details

To edit the details of a Notebook version, select a version in the Version History pane. Select the ellipsis (three dots) in the selected version, and select Edit Details. Alternatively, you can select the version name/timestamp of the selected version, and then select the Edit Details button in the upper right of the View Details dialog.

An image that shows how to edit Notebook version details by using the highlighted "Edit Details" button.

In the Edit Version Details dialog, enter the Version Name and Description.

An image that shows a Notebook version's details. The version name and description can updated, and these updates saved by using the "Save Changes" button.

Add a Version to Favorites

To bookmark a Notebook version, select a version in the Version History pane. Select the ellipsis (three dots) in the selected version, and select Add to Favorites. After adding a version to favorites, a list of bookmarks (favorite versions) is displayed under Favorites, above Version History, in the Version History pane. To permanently keep a version, transfer it to the Favorites list, which has a limit of 10 versions. However, versions in Favorites are always retained. To add an 11th version to Favorites, you must delete or remove an existing version.

An image that show how to add a Notebook version to your favorites.

Remove a Version from Favorites

To remove a version of the Notebook from Favorites, select a version in the Version History pane. Select the ellipsis (three dots) in the selected version, and select Remove from Favorites.

Duplicate a Version

To duplicate a version of the Notebook, select a version in the Version History pane. Select the ellipsis (three dots) in the selected version, and select Duplicate version. In the Duplicate from <version_name> dialog, enter the name in Notebook Name, and select Duplicate Notebook.

An image that shows how to duplicate a Notebook using the "Duplicate Notebook" button.

Restore a Version

To restore a version of the Notebook, select a version in the Version History pane. Select the ellipsis (three dots) next to the selected version, and select Restore version. Alternatively, you can restore a version by selecting the Restore Version button at the bottom.

Note

Restoring a version replaces the current contents of the Notebook with the version you selected.

An image that shows how to restore a Notebook version by using the highlighted "Restore Version" button.

Delete a Version

To delete a version of the Notebook, select a version in the Version History pane. Select the ellipsis (three dots) in the selected version, and select Delete version.

Last modified: February 24, 2025

Was this article helpful?

Verification instructions

Note: You must install cosign to verify the authenticity of the SingleStore file.

Use the following steps to verify the authenticity of singlestoredb-server, singlestoredb-toolbox, singlestoredb-studio, and singlestore-client SingleStore files that have been downloaded.

You may perform the following steps on any computer that can run cosign, such as the main deployment host of the cluster.

  1. (Optional) Run the following command to view the associated signature files.

    curl undefined
  2. Download the signature file from the SingleStore release server.

    • Option 1: Click the Download Signature button next to the SingleStore file.

    • Option 2: Copy and paste the following URL into the address bar of your browser and save the signature file.

    • Option 3: Run the following command to download the signature file.

      curl -O undefined
  3. After the signature file has been downloaded, run the following command to verify the authenticity of the SingleStore file.

    echo -n undefined |
    cosign verify-blob --certificate-oidc-issuer https://oidc.eks.us-east-1.amazonaws.com/id/CCDCDBA1379A5596AB5B2E46DCA385BC \
    --certificate-identity https://kubernetes.io/namespaces/freya-production/serviceaccounts/job-worker \
    --bundle undefined \
    --new-bundle-format -
    Verified OK