Migrating to Notebook 7#

Updated 2023-05-17


Version 7 of the Jupyter Notebook application might break your extensions or other customizations. Please read this page to find out if you need to take any actions to ensure a smooth, uninterrupted experience.

A major upgrade to the Jupyter Notebook interface is coming with Notebook 7! This upgrade will bring a heap of new features, but will also break backwards compatibility with many classic Notebook features and customizations.

This set of guides is here to help you migrate your Classic Notebook setup and extensions to the new Notebook 7.

What you need to do#

For users who don’t use extensions or other customizations, you will seamlessly receive the new Notebook 7 when you pip install notebook once version 7 is released out of beta, along with all its new features, like realtime collaboration, debugger, and theming.

For users who need to use extensions or other customizations, you have a couple of options:

  • Look for Notebook 7 compatible versions of the extensions you already use, and find replacements for those that are not available

  • If you need to maintain compatibility with the Classic Notebook for extensions or other customizations that are critical to your workflows, you can switch to nbclassic, which will provide compatibility with the old notebook interface and support during an intermediate transition period to Notebook 7

Why a new version?#

For the past few years, the Classic Jupyter Notebook has been in maintenance mode.

Development has mostly moved to alternative user interfaces like JupyterLab, which is a more modern and extensible web application. This has resulted in a lot of new features and improvements in JupyterLab, but also in a lot of new features and improvements that were not possible to integrate to the Classic Notebook.

For a while, the plan was to progressively sunset the Classic Notebook and not maintain it anymore. However, the Classic Notebook is still widely used and it is still the default user interface for Jupyter in many scenarios. Many users and organizations have not been able to switch to JupyterLab yet. For some users, JupyterLab can also be a more complex environment to use, especially for beginners.

Following the feedback from the community, it was decided in late 2021 to continue developing the Jupyter Notebook application and sunrise it as Notebook 7.

You can find more details about the changes currently taking place in the Jupyter Ecosystem in the JEP 79 and team-compass note.

New features in Notebook 7#

Migration Guides#