napari 0.7.0

⚠️ Note: these release notes are still in draft while 0.7.0 is in release candidate testing. ⚠️

Tue, Jan 27, 2026

We're happy to announce the release of napari 0.7.0! napari is a fast, interactive, multi-dimensional image viewer for Python. It's designed for browsing, annotating, and analyzing large multi-dimensional images. It's built on top of Qt (for the GUI), vispy (for performant GPU-based rendering), and the scientific Python stack (numpy, scipy).

For more information, examples, and documentation, please visit our website, https://napari.org.

napari follows EffVer (Intended Effort Versioning); this is a Macro release containing awesome new features, but may require dedication of some significant time when upgrading projects to use this version.

Highlights

More detail coming soon...

Transition to npe2 plugin engine 🔌

In 0.6.0 we began the process of deprecating npe1 (napari-plugin-engine). In all 0.6.x releases, npe1 plugins were automatically converted to npe2 by default, and users could turn off the use_npe2_adaptor setting to continue using npe1 plugins without auto-conversion.

In 0.7.0 this setting is being removed, and plugins will only continue to function if they can be auto-converted to npe2. Most plugins will be unaffected, but those that rely on import-time behaviour may not work as expected. If a plugin is relying on import-time behaviour, it may be able to replicate this using the new startup scripts functionality added in 0.6.5 (#8188).

If you encounter conversion issues in a plugin you rely on, please contact the plugin authors to encourage them to migrate their plugin to the npe2 system.

For more details on this change and how it affects plugins, see the detailed guide. If you are a plugin author and your plugin is not yet npe2-compatible, please see our npe2 migration guide, and, if you encounter any issues, get in touch in our Plugins Zulip chat channel or by coming to one of our community meetings.

Grid Overlay

...

• Multilayer features table (#8189)
• Fix camera angles‽ (#8281)
• Remove numpydoc as a base and testing dependency (#8338)
• Histogram (#8391)
• Texture tiling (#8395)
• Fix overlay initialization and layer addition slowdown (#8443)
• Remove shim setting and warning dialog (#8448)
• Remove PySide2 support (#8450)
• Speed up the deletion of layers by deduplicating the function calls (#8479)
• Remove npe1 settings and theme loading (#8540)
• Use negative indexing for viewer dims axis labels (#8565)

New Features

• Use information about units when calculate scale of layers when render (#7889)
• Cursor overlay (#8017)
• Welcome widget as an overlay (#8117)
• Multilayer features table (#8189)
• Better text overlay (and subclasses) (#8236)
• Allow create Shapes and Points per selected Layer (#8357)
• Histogram (#8391)

Improvements

• perf: reallocate instead of clearing and repopulating set of selected points (#6895)
• Add a seed argument to built-in samples with random seeds (#8317)
• Enh: clarify Points selection keybinding behavior: select_in_slice not append by default, add new select_append_in_slice (#8339)
• Enh: Improve zarr reading by builtins (#8355)
• ENH: Speedup multiple shapes removal by concat'ing and np.deleting as a batch (#8375)
• Enh: Speed up shapes box selection by using bounding boxes and vectorization (#8378)
• Reordering default colormap to split channels (#8383)
• change default blending mode of images on split RGB (#8385)
• Texture tiling (#8395)
• Enh: simple speed up of Shapes _extent_data (#8401)
• Enh: performance optimizations to ShapeList outlines (#8403)
• Enh: Throttle shapes highlight (#8404)
• Set viewer dimension based on number of axis labels (#8436)
• Enh: Add label value to the labels tooltip (#8495)
• Use 10x10 pixels rect around mouse position to invalidate tooltip (#8500)
• Bump to vispy 0.16 (#8501)
• Enable antialiasing on all Lines (#8515)
• Avoid materializing property views when updating points highlight (#8517)
• Add caching of outlines to reduce delay on Shapes zoom (#8536)
• Use negative indexing for viewer dims axis labels (#8565)

Performance

• perf: reallocate instead of clearing and repopulating set of selected points (#6895)
• ENH: Speedup multiple shapes removal by concat'ing and np.deleting as a batch (#8375)
• Enh: Speed up shapes box selection by using bounding boxes and vectorization (#8378)
• Enh: simple speed up of Shapes _extent_data (#8401)
• Enh: performance optimizations to ShapeList outlines (#8403)
• Enh: Throttle shapes highlight (#8404)
• Fix unnecessary overlay initialization on scenegraph update (#8423)
• Fix overlay initialization and layer addition slowdown (#8443)
• Cap point highlight size (#8504)
• Add caching of outlines to reduce delay on Shapes zoom (#8536)
• Fix the Shapes mode setter to use is_creating for _finish_drawing and clear selection when going to ADD* (#8551)
• Delay scipy imports until needed (#8561)

Bug Fixes

• Fix camera angles‽ (#8281)
• bugfix & refactor: Use events for shape multiselection (#8332)
• Fix conversion of vector images to coordinates of vectors (#8366)
• initialize label selection spinbox to a correct value (#8382)
• Bugfix: fix erratic Shape sorting (#8408)
• Bugfix: update magicgui layer combobox if a layer is renamed (#8412)
• bugfix: Ensure that edge_width is accounted for when using polygon lasso (#8414)
• Fix Shapes thumbnail z ordering (#8417)
• Fix unnecessary overlay initialization on scenegraph update (#8423)
• Bugfix: update magicgui layer combobox if a layer is renamed using LayerList.renamed event (#8429)
• Fix overlay initialization and layer addition slowdown (#8443)
• Bugfix: ensure triangle colors are updated properly when using polygon lasso (#8469)
• Speed up the deletion of layers by deduplicating the function calls (#8479)
• Bump to vispy 0.16 (#8501)
• Cap point highlight size (#8504)
• Bugfix: recurse through sub-fields when making connections in EventedSettings Config (#8520)
• Fix rendering of 2D rgb data in 3D mode (#8522)
• Fix numpy warning for pure python edge triangulation (#8523)
• Do not use keyword argument when creating tooltip (#8528)
• Fix angle label values in ndim popup widget (#8535)
• Fix update of shape that lead to wrong rendering (#8543)
• Fix the Shapes mode setter to use is_creating for _finish_drawing and clear selection when going to ADD* (#8551)
• Do not expose legacy angle (#8557)
• ensure overlays are reused properly when gridded mode is enabled (#8569)

Build Tools

• Bump urllib3 from 2.5.0 to 2.6.0 in /resources (#8484)
• Migrate overlays to psygnal (#8492)
• Bump urllib3 from 2.6.2 to 2.6.3 in /resources (#8544)

Documentation

• Create 3D_vectors_through_time.py (#8461)
• Fix and improve dock_widgets docstrings (#8494)
• Remove deprecated view_* methods from docs materials (docs#864)
• Proposed roadmap updates for Q3 (docs#873)
• Enhance documentation build process with pixi integration and Windows… (docs#876)
• Pixi cross platform support (docs#879)
• Refactor contributor docs: prioritize pixi for local builds (docs#880)
• Modernize type annotation to use builtins (docs#883)
• Update dark mode colors (docs#884)
• Remove outdated mentions about PySide2 in documentation (docs#889)
• Explain accessing dock widget wrappers (docs#892)
• Add v0.7.0 release notes (docs#893)
• Add npe1 deprecation info to release notes (docs#894)
• Overwrite pooch downloader to fix Zenodo access problems (docs#895)
• Update docs ahead of 0.7.0 alpha (docs#897)
• Update website to use new logos (docs#901)
• Migrate and update hub customization from wiki to docs (docs#906)
• Improve open image section (docs#907)
• Remove mention of outdated plugin from quick start (docs#908)
• increase stack size to solve import recursion problem (docs#912)

Other Pull Requests

• Add codespell support (config, workflow to detect/not fix) and make it fix few typos (#7619)
• Clipping planes control widget (#7993)
• Add cell tracking example (#8051)
• TYP: overload for labeled_particles incorrectly notes Literal[True]=... as default for return_density (#8114)
• Decompose Layer code by move slicing to specialized class (#8254)
• Update hypothesis, psygnal (#8310)
• Add information about pyside 6 in error information (#8313)
• Remove numpydoc as core dependency, instead use docstring_parser (#8334)
• Remove deprecated napari.view_* methods (#8337)
• [pre-commit.ci] pre-commit autoupdate (#8354)
• Remove string translation from PR checklist (#8362)
• Use coverage upload from shared workflows (#8367)
• Specify napari revision in build and deploy docs workflow (#8368)
• [pre-commit.ci] pre-commit autoupdate (#8369)
• Switch PyPI downloads badge in README (#8374)
• Update citation file for 0.7.0 (#8384)
• [pre-commit.ci] pre-commit autoupdate (#8386)
• Add check if PR author is in citation.cff (#8388)
• skip check if author in citation.cff if bot created PR (#8392)
• Explicitly turn on full checkout for CircleCI (#8396)
• ci(dependabot): bump the actions group with 3 updates (#8400)
• Exclude dependabot from PR author check (#8409)
• Fix cff check for bots (#8420)
• Add colorbar and overlay tiling example (#8433)
• Update certifi, coverage, dask, fsspec, hypothesis, imageio, ipython, matplotlib, numpy, pandas, pillow, pint, psutil, psygnal, pydantic, pyqt6, pyside6, pytest, pytest-rerunfailures, pyyaml, rich, scipy, tensorstore, tifffile, toolz, virtualenv, wrapt, xarray (#8441)
• [pre-commit.ci] pre-commit autoupdate (#8442)
• Stop updating python 3.10 docs constraints (#8444)
• Block problematic numba in docs constraints (#8454)
• Change link to getting started in Help menu (#8455)
• Update coverage, dask, fsspec, hypothesis, ipython, matplotlib, pydantic, pyqt6, pyside6, pytest, tensorstore, tifffile, xarray (#8456)
• Use new logos! (#8457)
• [pre-commit.ci] pre-commit autoupdate (#8458)
• ci(dependabot): bump the actions group across 1 directory with 7 updates (#8460)
• Finish typing napari.layers.image (#8462)
• Bugfix: For FeatureTable edit test, check the QAbstractItemView.State and not isPersistentEditorOpen (#8463)
• Move Ashley Anderson citation to core team section (#8467)
• Change exclude to extend-exclude in ruff config (#8468)
• Fix constraints upgrade scripts (#8473)
• Fix coverage upload in comprehensive tests (#8474)
• Remove building of npe1 menu items for Plugins and Sample menus (#8476)
• First emit warning, then replace projection mode when convert image to labels (#8481)
• Finish typing utils.progress (#8485)
• Maint: Update test_prereleases.yml to bump retries to 3 (#8488)
• Block numba 0.62.0 for docs constraints (#8490)
• [pre-commit.ci] pre-commit autoupdate (#8491)
• [pre-commit.ci] pre-commit autoupdate (#8499)
• Test on macos-15-intel without numba (#8503)
• Move constraints calculation to script, allow upgrade subset of packages (#8505)
• Workaround for Zenodo outage by downloading data from google drive. (#8508)
• Fix overlay tests (#8513)
• [pre-commit.ci] pre-commit autoupdate (#8519)
• Reduce noise in benchmark logs (#8525)
• Improve language in Citation PR Author check (#8526)
• ci(dependabot): bump the actions group with 4 updates (#8533)
• Enforce unix line endings (#8541)
• Add temporary tox plugin for fix installation of dependency groups (#8545)
• Revert: Add temporary tox plugin for fix installation of dependency groups (#8545) (#8546)
• Fix path to constraints update script (#8553)
• [pre-commit.ci] pre-commit autoupdate (#8554)
• Stop using get_settings during import time (#8556)
• Fix test on PySide6 by change mocking of qt methods (#8560)
• Remove 'axis' prefix from layer axis labels (#8566)
• [pre-commit.ci] pre-commit autoupdate (#8571)
• ci(dependabot): bump the github-actions group with 4 updates (docs#856)
• Allow to redeploy docs after merge new commits to main branch (docs#874)
• Add mdformat to pre-commit config (docs#878)
• Reorg of the Usage section of the docs (docs#881)
• Explicitly turn on blobless checkout for CircleCI (docs#882)
• ci(dependabot): bump the github-actions group with 3 updates (docs#885)
• ci(dependabot): bump the github-actions group with 3 updates (docs#890)
• ci(dependabot): bump the github-actions group with 3 updates (docs#898)
• Allow to use local copy of napari when using pixi (docs#900)
• Fix pixi tasks for different environments (docs#904)
• Stop tracking docs/release/index.md so that it is ignored (docs#905)
• Maint Update PIP_CONSTRAINT to UV_CONSTRAINT in config (docs#909)
• Remove pixi configuration for macos intel (docs#913)

17 authors added to this release (alphabetical)

(+) denotes first-time contributors 🥳

• Ashley Anderson - @aganders3
• Daniel Zhang - @DanGonite57
• David Stansby - @dstansby
• Draga Doncila Pop (docs) - @DragaDoncila
• Edward Andò - @edwardando +
• Grzegorz Bokota (docs) - @Czaki
• Guillaume Witz - @guiwitz
• Juan Nunez-Iglesias - @jni
• Lorenzo Gaifas (docs) - @brisvag
• Marco Edward Gorelli - @MarcoGorelli +
• Melissa Weber Mendonça (docs) - @melissawm
• Peter Sobolewski (docs) - @psobolewskiPhD
• Qin Yu (docs) - @qin-yu +
• Rensu Theart - @rensutheart +
• Tim Monko (docs) - @TimMonko
• Yohsuke T. Fukai - @yfukai +
• Zuzana Čočková - @cockovaz +

22 reviewers added to this release (alphabetical)

(+) denotes first-time contributors 🥳

• Ashley Anderson - @aganders3
• Carol Willing - @willingc
• Daniel Zhang - @DanGonite57
• David Stansby - @dstansby
• Draga Doncila Pop (docs) - @DragaDoncila
• Edward Andò - @edwardando +
• Gabriel Selzer - @gselzer
• Grzegorz Bokota (docs) - @Czaki
• Guillaume Witz - @guiwitz
• Jacopo Abramo - @jacopoabramo
• Johannes Soltwedel - @jo-mueller
• Juan Nunez-Iglesias - @jni
• Lorenzo Gaifas (docs) - @brisvag
• Marcelo Zoccoler - @zoccoler
• Marco Edward Gorelli - @MarcoGorelli +
• Melissa Weber Mendonça (docs) - @melissawm
• Peter Sobolewski (docs) - @psobolewskiPhD
• Rensu Theart - @rensutheart +
• Sesan - @Olusesan
• Tim Monko (docs) - @TimMonko
• Yaroslav Halchenko - @yarikoptic
• Zuzana Čočková - @cockovaz +