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_displayedoverlay 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
imshowto not setndisplayandorderif 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.pyandbase.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.pyand_typed.py(#9716)TYP: add type hints in
action_manager.py,_test_utils.pyand_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
tox4.67.5 for pre tests to make it working (#9846)Enable stacktrace, disable graphviz in
--pretests (#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)
12 reviewers added to this release (alphabetical)#
(+) denotes first-time contributors 🥳
Aman kumar - @ghostiee-11
Aniket - @Aniketsy
Carlos Mario Rodriguez Reza - @carlosmariorr
Clément Caporal - @ClementCaporal
Grzegorz Bokota (docs) - @Czaki
Jacopo Abramo - @jacopoabramo
lettyz3 - @lettyz3
Lorenzo Gaifas - @brisvag
Lundy Bernard (docs) - @lundybernard +
Peter Sobolewski - @psobolewskiPhD
Sparsh Vikas - @TheCreeperrr +