zarr-developers · d-v-b · Mar 19, 2026 · Mar 19, 2026 · Mar 19, 2026 · Mar 19, 2026
diff --git a/changes/3464.doc.md b/changes/3464.doc.md
diff --git a/changes/3562.misc.md b/changes/3562.misc.md
diff --git a/changes/3603.bugfix.md b/changes/3603.bugfix.md
diff --git a/changes/3605.misc.md b/changes/3605.misc.md
diff --git a/changes/3619.misc.md b/changes/3619.misc.md
diff --git a/changes/3623.misc.md b/changes/3623.misc.md
diff --git a/changes/3636.misc.md b/changes/3636.misc.md
diff --git a/changes/3648.misc.md b/changes/3648.misc.md
diff --git a/changes/3655.bugfix.md b/changes/3655.bugfix.md
diff --git a/changes/3656.misc.md b/changes/3656.misc.md
diff --git a/changes/3657.bugfix.md b/changes/3657.bugfix.md
diff --git a/changes/3658.misc.md b/changes/3658.misc.md
diff --git a/changes/3668.feature.md b/changes/3668.feature.md
diff --git a/changes/3673.misc.md b/changes/3673.misc.md
diff --git a/changes/3695.bugfix.md b/changes/3695.bugfix.md
diff --git a/changes/3700.bugfix.md b/changes/3700.bugfix.md
diff --git a/changes/3702.bugfix.md b/changes/3702.bugfix.md
diff --git a/changes/3704.misc.md b/changes/3704.misc.md
diff --git a/changes/3705.bugfix.md b/changes/3705.bugfix.md
diff --git a/changes/3706.misc.md b/changes/3706.misc.md
diff --git a/changes/3708.misc.md b/changes/3708.misc.md
diff --git a/changes/3710.bugfix.md b/changes/3710.bugfix.md
diff --git a/changes/3712.misc.md b/changes/3712.misc.md
diff --git a/changes/3713.misc.md b/changes/3713.misc.md
diff --git a/changes/3717.misc.md b/changes/3717.misc.md
diff --git a/changes/3721.misc.md b/changes/3721.misc.md
diff --git a/changes/3728.misc.md b/changes/3728.misc.md
diff --git a/changes/3769.doc.md b/changes/3769.doc.md
diff --git a/changes/3778.misc.md b/changes/3778.misc.md
diff --git a/docs/release-notes.md b/docs/release-notes.md
@@ -2,6 +2,42 @@
 
 <!-- towncrier release notes start -->
 
+## 3.1.6 (2026-03-19)
+
+### Features
+
+- Exposes the array runtime configuration as an attribute called `config` on the `Array` and
+  `AsyncArray` classes. The previous `AsyncArray._config` attribute is now a deprecated alias for `AsyncArray.config`. ([#3668](https://github.com/zarr-developers/zarr-python/issues/3668))
+- Adds a method for creating a new `Array` / `AsyncArray` instance with a new runtime configuration, and fixes inaccurate documentation about the `write_empty_chunks` configuration parameter. ([#3668](https://github.com/zarr-developers/zarr-python/issues/3668))
+- Adds synchronous methods to stores that do not benefit from an async event loop. The shape of these methods is defined by protocol classes to support structural subtyping. ([#3725](https://github.com/zarr-developers/zarr-python/pull/3725))
+- Fix near-miss penalty in `_morton_order` with hybrid ceiling+argsort strategy. ([#3718](https://github.com/zarr-developers/zarr-python/pull/3718))
+
+### Bugfixes
+
+- Correct the target bytes number for auto-chunking when auto-sharding. ([#3603](https://github.com/zarr-developers/zarr-python/issues/3603))
+- Fixed a bug in the sharding codec that prevented nested shard reads in certain cases. ([#3655](https://github.com/zarr-developers/zarr-python/issues/3655))
+- Fix obstore `_transform_list_dir` implementation to correctly relativize paths (removing `lstrip` usage). ([#3657](https://github.com/zarr-developers/zarr-python/issues/3657))
+- Raise error when trying to encode :class:`numpy.dtypes.StringDType` with `na_object` set. ([#3695](https://github.com/zarr-developers/zarr-python/issues/3695))
+- `CacheStore`, `LoggingStore` and `LatencyStore` now support with_read_only. ([#3700](https://github.com/zarr-developers/zarr-python/issues/3700))
+- Skip chunk coordinate enumeration in resize when the array is only growing, avoiding unbounded memory usage for large arrays. ([#3702](https://github.com/zarr-developers/zarr-python/issues/3702))
+- Fix a performance bug in morton curve generation. ([#3705](https://github.com/zarr-developers/zarr-python/issues/3705))
+- Add a dedicated in-memory cache for byte-range requests to the experimental `CacheStore`. ([#3710](https://github.com/zarr-developers/zarr-python/issues/3710))
+- `BaseFloat._check_scalar` rejects invalid string values. ([#3586](https://github.com/zarr-developers/zarr-python/issues/3586))
+- Apply drop_axes squeeze in partial decode path for sharding. ([#3763](https://github.com/zarr-developers/zarr-python/issues/3763))
+- Set `copy=False` in reshape operation. ([#3649](https://github.com/zarr-developers/zarr-python/issues/3649))
+- Validate that dask-style chunks have regular shapes. ([#3779](https://github.com/zarr-developers/zarr-python/issues/3779))
+
+### Improved Documentation
+
+- Add documentation example for creating uncompressed arrays in the Compression section of the user guide. ([#3464](https://github.com/zarr-developers/zarr-python/issues/3464))
+- Add AI-assisted code policy to the contributing guide. ([#3769](https://github.com/zarr-developers/zarr-python/issues/3769))
+- Added a glossary. ([#3767](https://github.com/zarr-developers/zarr-python/issues/3767))
+
+### Misc
+
+- [#3562](https://github.com/zarr-developers/zarr-python/issues/3562), [#3605](https://github.com/zarr-developers/zarr-python/issues/3605), [#3619](https://github.com/zarr-developers/zarr-python/issues/3619), [#3623](https://github.com/zarr-developers/zarr-python/issues/3623), [#3636](https://github.com/zarr-developers/zarr-python/issues/3636), [#3648](https://github.com/zarr-developers/zarr-python/issues/3648), [#3656](https://github.com/zarr-developers/zarr-python/issues/3656), [#3658](https://github.com/zarr-developers/zarr-python/issues/3658), [#3673](https://github.com/zarr-developers/zarr-python/issues/3673), [#3704](https://github.com/zarr-developers/zarr-python/issues/3704), [#3706](https://github.com/zarr-developers/zarr-python/issues/3706), [#3708](https://github.com/zarr-developers/zarr-python/issues/3708), [#3712](https://github.com/zarr-developers/zarr-python/issues/3712), [#3713](https://github.com/zarr-developers/zarr-python/issues/3713), [#3717](https://github.com/zarr-developers/zarr-python/issues/3717), [#3721](https://github.com/zarr-developers/zarr-python/issues/3721), [#3728](https://github.com/zarr-developers/zarr-python/issues/3728), [#3778](https://github.com/zarr-developers/zarr-python/issues/3778)
+
+
 ## zarr 3.1.5 (2025-11-21)
 
 ## Bugfixes