napari 0.10.1#

⚠️ Note: these release notes are still in draft while 0.10.1a0 is in prerelease testing. ⚠️

Mon, Nov 23, 2026

We’re happy to announce the release of napari 0.10.1! 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 Meso release containing awesome new features, but some effort may be needed when updating previous projects to use this version.

Highlights#

  • Skip the canvas cleanup when closing the viewer (#9870)

New Features#

  • Add dims_displayed overlay showing the currently displayed axes (#9855)

Improvements#

  • Anchor all viewer button popups to viewer (#8953)

  • Rasterize paths that leave their plane as nD lines (#9584)

  • Add percentiles option to calc_data_range and reset_contrast_limits (#9691)

  • Fix saving multiscale layers with the built-in writer (#9693)

  • Add detection of deprecated properties, create warning in EventedModel (#9701)

  • Add text scaling checkbox to Points and Shapes layer controls (#9838)

Performance#

  • [labels, perf] Batch paint stamps (#9469)

  • [Shapes, perf] Avoid rebuilding Shapes Layer.data by using Layer.nshapes and Layer._data_view.shapes (#9501)

  • [Shapes, perf] Shapes batch display updates (#9502)

  • [perf] Slice only after setting centered view (only affects async) (#9698)

  • [perf] Use numpy for thumbnails, to avoid scipy import and duplicate code (#9858)

  • Postpone welcome widget refresh while it is not visible (#9869)

  • Skip the canvas cleanup when closing the viewer (#9870)

  • Refactor data/thumbnail materializers (#9908)

Bug Fixes#

  • TYP: add type hints in _testsupport.py (#9237)

  • TYP: add type hints in _magicgui.py (#9543)

  • Add native value search in EnumSchemaWidgets to ensure boolean type compatibility (#9591)

  • Add layers from Future results on the main thread (#9686)

  • Fix saving multiscale layers with the built-in writer (#9693)

  • Allow private classes to generate private _add_* methods (#9766)

  • Include point border in Points hover and selection hit-testing (#9790)

  • Fix overlay draws during new viewboxes from new layers (#9799)

  • Fix wrong term in rotation_matrix_from_vectors_2d (#9817)

  • Fix floating coordinate grid plane for 2D data in 3D view (#9827)

  • Fix disconnecting old transform in TransformChain.setitem (#9835)

  • fix imshow to not set ndisplay and order if not passed explicitly (#9850)

  • Fix thread worker warnings (#9883)

  • Fix warning notifications without arguments (#9884)

Documentation#

  • core dev guide text improvement (docs#1170)

  • Redirect coredev files to core_team (docs#1194)

  • docs: update moved, dead, and src/ layout links (docs#1195)

  • docs: link NAP 2 release-guide footnote by label (docs#1206)

  • docs: update permanently redirected links (docs#1208)

  • docs: update links that redirect to a canonical page (docs#1210)

  • Super speed up the UI diagram prep (docs#1212)

  • perf: add napari pull and issue links to linkcheck_ignore (docs#1214)

  • docs: add section anchors and https to five links (docs#1217)

  • Fix example highlight styling on the homepage (docs#1224)

  • Fix homepage and community quicklink icon sizes (docs#1225)

  • docs: update moved tutorial links in two examples (#9810)

  • Add Parameters section to compute_nice_ticks docstring (#9842)

  • doc: fix wrong ndim description for point layer (#9915)

Other Pull Requests#

  • [pre-commit.ci] pre-commit autoupdate (docs#1189)

  • fix: update the link check config in conf.py and linkcheck.yml (docs#1196)

  • ci(dependabot): bump the github-actions group with 4 updates (docs#1198)

  • Fix Make on Windows to use env vars during docs builds (docs#1203)

  • fix: allow redirects and ignore blocked hosts in the link check (docs#1207)

  • update circle ci redirector version (docs#1218)

  • [pre-commit.ci] pre-commit autoupdate (docs#1222)

  • Silence sphinx-design==0.8.0 warning (docs#1223)

  • Add CITATION.cff validation and re-order authors (with pre-commit) (#9155)

  • TYP: add type hints in _vispy/canvas.py and base.py (#9202)

  • TYP: add type hints in _evented_list.py (#9241)

  • fix(typing): annotate napari/utils/key_bindings.py (#9253)

  • TYP: add type hints in _multiscale_data.py (#9549)

  • TYP: add type hints in qt_scrollbar.py (#9654)

  • TYP: add type hints in qt_highlight_preview.py (#9657)

  • TYP: add type hints in view_layers.py (#9679)

  • Add timeout to –pre tests (#9711)

  • TYP: add type hints in geometry.py and _typed.py (#9716)

  • TYP: add type hints in action_manager.py , _test_utils.py and _register.py (#9718)

  • Update bug report template to contain more recent version of napari --info (#9721)

  • chore: remove superseded code (#9769)

  • TYP: add reusable Vector1D/Matrix2D type aliases (#9782)

  • Remove unused grid_points_in_poly function (#9802)

  • ci: default toxworkdir to {toxinidir}/.tox (#9826)

  • ci(dependabot): bump the actions group across 1 directory with 9 updates (#9843)

  • Update hypothesis, ipython, npe2, platformdirs, pydantic, pydantic-settings, pyqt6, pyqt6-qt6, pytest, superqt, tensorstore, virtualenv, wrapt (#9844)

  • Block tox 4.67.5 for pre tests to make it working (#9846)

  • Enable stacktrace, disable graphviz in --pre tests (#9847)

  • [pre-commit.ci] pre-commit autoupdate (#9851)

  • Speed up test suite: gc.freeze, cached builtins manifest, no sleeps in label color tests (#9854)

  • Fix deadlock between slicing thread and main thread on PySide6 (#9856)

  • Fail quicker at end of test sections on CI (#9868)

  • Update coverage, hypothesis, ipython, npe2, pandas, platformdirs, pydantic, tifffile, virtualenv (#9873)

  • [pre-commit.ci] pre-commit autoupdate (#9877)

  • Update the comment in VispyCanvas.screenshot() to reflect current state (#9878)

  • Remove stubgen from napari workflow, fix type annotation and naming of helpers (#9879)

  • Fix flaky test_play_button and abort when closing a playing QtDims (#9885)

  • Skip coverage upload when initial tests fail (#9887)

  • Deprecate rotation_matrix_from_vectors_2d (#9888)

  • Change Tim Monko’s affiliation in Citation file (#9894)

  • Fix CircleCI redirector by bumping action version (#9895)

  • Silence SC2016 for the git credential helper in upgrade_test_constraints (#9896)

  • Fix missing f-prefix in git diff error message of check_updated_packages (#9899)

  • Use PySide6-Essentials instead of the PySide6 metapackage (#9905)

  • [pre-commit.ci] pre-commit autoupdate (#9909)

  • [perf] Labels: Use layer.data.dtype instead of materializing lazy arrays in get_dtype (#9912)

18 authors added to this release (alphabetical)#

(+) denotes first-time contributors 🥳

12 reviewers added to this release (alphabetical)#

(+) denotes first-time contributors 🥳