Migrating#

Updated 2023-05-17

Warning

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

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

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

What you need to do#

For users who don’t use extensions or other customizations, you will seamlesslyreceive the new Notebook 7 when youpipinstallnotebook once version 7 isreleased out of beta, along with all its new features, like realtimecollaboration, debugger, and theming.

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

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

  • If you need to maintain compatibility with the Classic Notebook for extensionsor other customizations that are critical to your workflows, you can switch tonbclassic, which will provide compatibility with the old notebook interfaceand 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 maintenancemode.

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

For a while, the plan was to progressivelysunset the Classic Notebook andnot maintain it anymore. However, the Classic Notebook is still widely usedand 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 tocontinue developing the Jupyter Notebook application andsunrise it asNotebook 7.

You can find more details about the changes currently taking place in theJupyter Ecosystem in theJEP 79 andteam-compass note.

New features in Notebook 7#

Migration Guides#