{"id":5273,"library":"jupyter-nbextensions-configurator","title":"Jupyter Nbextensions Configurator","description":"Jupyter Nbextensions Configurator is a Jupyter server extension that provides graphical user interfaces for configuring notebook extensions (nbextensions). It allows users to enable or disable nbextensions and, for those with appropriate YAML descriptor files, to configure their specific options and view their README documentation. The library is currently at version 0.6.4 and is actively maintained with periodic releases addressing compatibility and bug fixes.","status":"active","version":"0.6.4","language":"en","source_language":"en","source_url":"https://github.com/jupyter-contrib/jupyter_nbextensions_configurator","tags":["jupyter","notebook","extension","nbextension","configuration","serverextension","frontend"],"install":[{"cmd":"pip install jupyter_nbextensions_configurator\njupyter nbextensions_configurator enable --user","lang":"bash","label":"pip install and enable for user"},{"cmd":"conda install -c conda-forge jupyter_nbextensions_configurator","lang":"bash","label":"conda install"}],"dependencies":[{"reason":"Functions as a Jupyter Notebook server extension. Requires a compatible Jupyter Notebook environment to operate. Newer Jupyter versions might require `jupyter_server` instead of `notebook` for core server functionalities, or use `nbclassic` for Notebook v6 compatibility.","package":"notebook"},{"reason":"While not a direct dependency for the configurator to run, it is the primary collection of nbextensions that this configurator is designed to manage and configure. Often installed together.","package":"jupyter_contrib_nbextensions"}],"imports":[],"quickstart":{"code":"# 1. Install the configurator (if not already installed)\npip install jupyter_nbextensions_configurator\n\n# 2. Enable the server extension for the current user\njupyter nbextensions_configurator enable --user\n\n# 3. Start Jupyter Notebook\njupyter notebook\n\n# After starting Jupyter, open your web browser to the Jupyter home page.\n# You should see a new 'Nbextensions' tab. Click it to manage and configure\n# your installed notebook extensions.","lang":"bash","description":"Install the `jupyter_nbextensions_configurator` package, then enable its server extension. After restarting your Jupyter Notebook server, a new 'Nbextensions' tab will appear on the Jupyter home page (file browser), allowing you to manage and configure all detected notebook extensions."},"warnings":[{"fix":"For full compatibility with older nbextensions, consider running Jupyter Notebook v6 or using `nbclassic` (pip install nbclassic) alongside newer Jupyter versions to provide a compatible environment. Check individual nbextension compatibility.","message":"Jupyter Notebook v7 (and newer versions based on JupyterLab) fundamentally changed the extension system. While `jupyter_nbextensions_configurator` version 0.6.4 includes fixes for its own compatibility with Notebook v7, many of the individual nbextensions it is designed to manage (especially those from `jupyter_contrib_nbextensions`) are not compatible with Notebook v7 and will not function correctly.","severity":"breaking","affected_versions":"<0.6.4 (configurator itself), all versions (for many managed nbextensions on Notebook v7+)"},{"fix":"Run `jupyter nbextensions_configurator enable --user` (or `--system`, `--sys-prefix` as appropriate) after `pip install`. Remember to restart your Jupyter Notebook server afterwards.","message":"After installing the Python package, the server extension must be explicitly enabled using a `jupyter` subcommand. Failing to do so will result in the 'Nbextensions' tab not appearing in your Jupyter Notebook interface.","severity":"gotcha","affected_versions":"All versions"},{"fix":"Consult the `jupyter_contrib_nbextensions` troubleshooting guide for steps to remove duplicate entries, which often involves uninstalling old versions and manually cleaning Jupyter data directories using `jupyter --paths` to locate relevant paths.","message":"Upgrading or migrating from older installations of nbextensions or `jupyter_contrib_nbextensions` can lead to duplicate entries or 'incompatible' warnings in the configurator interface. This often happens due to leftover files in Jupyter data directories.","severity":"gotcha","affected_versions":"All versions, particularly after migrations or upgrades"},{"fix":"To mitigate, increase the `requirejs` timeout by adding `window.requirejs.config({waitseconds: 60});` (or a higher value) to your `custom.js` file. The location of `custom.js` can be found in Jupyter Notebook documentation.","message":"Some nbextensions may not load or function correctly in very large Jupyter notebooks due to JavaScript `requirejs` timeouts. This is an issue related to Jupyter's frontend loading mechanism.","severity":"gotcha","affected_versions":"All versions, depending on notebook size and specific extensions"}],"env_vars":null,"last_verified":"2026-04-13T00:00:00.000Z","next_check":"2026-07-12T00:00:00.000Z"}