# Notebook Version History 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 clock icon to select **Version History**. ![An image that shows the "Version History" icon within a Notebook.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/bltacb155ebce5d89f0/6a44f0a952835c3b1312795d/version_history_show_version_history-brXYs0.png) ## Compare Versions By default, the **Compare Version** toggle is on. To compare two versions, toggle on **Compare Version** and select the versions you want to compare. When you toggle off **Compare Version**, you can view the selected version on the right side of the panel in its complete n otebook 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.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt8e69d437ba6cae35/6a44f2b2a4fb1f67227e6d1f/version_history_compare_versions_1-0ilRKX.png) 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.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt0dcf2dc5a38426ff/6a44f2af58f84cb6cf389368/version_history_compare_versions_2-0HHOVY.png) ## 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 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. ![](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt637b65eec173e65c/6a44f2aa91c425c6ba730a65/version_history_view_details-CbcAB6.png) ## 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**. ![](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt03699ea8a5e0fe70/6a44f2ac2d05fa58a45be672/version_history_edit_version_details_1-pUpaOF.png) In the **Edit Version Details** dialog, enter the **Version Name** and **Description**. ![](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/bltc1b8b2167869bccc/6a44f092a56c88c5699745f4/version_history_edit_version_details_2-Ns0RP1.png) ## Add a Version to Favorites To bookmark a notebook version, select a version in the **Version History** pane and click on the star icon next to the selected version to add it 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.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt481b9101734c9cc9/6a44f2b5ddbfd1fa1390816e/version_history_add_version_to_favorites-3P7MD6.png) ## Remove a Version from Favorites Select a version in the **Version History** pane and tap on the star icon to remove it 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 \** dialog, enter the name in **Notebook Name** and the location, either Shared or Personal, and select **Duplicate Notebook**. ![An image that shows how to duplicate a Notebook using the "Duplicate Notebook" button.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blta51b26b55f21e24f/6a44f2ae9550a26acab9604d/version_history_duplicate_version-lrHAcR.png) ## 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.](https://images.contentstack.io/v3/assets/bltac01ee6daa3a1e14/blt6491990d3f4c7b55/6a44f2ab0efc343f819abd61/version_history_restore_version-b2fPSL.png) ## 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**. *** Modified at: November 17, 2025 Source: [/cloud/container-services/notebooks/notebook-version-history/](https://docs.singlestore.com/cloud/container-services/notebooks/notebook-version-history/) (An index of the documentation is available at /llms.txt)