-
New features
- Added an error check for trying to deserialize JAX exports that are older
than the backwards compatibility window. Without this check the
deserialization of expired artifacts may succeed and then result in
obscure downstream errors.
Added a configuration flag--jax_export_deserialize_expired_versionsto
temporarily bypass the error check.
See https://docs.jax.dev/en/latest/export/export.html#compatibility-guarantees. - Added
jax.numpy.top_k, which implementsnumpy.top_k, added in
in NumPy v2.6.0 (#39729).
- Added an error check for trying to deserialize JAX exports that are older
-
Breaking changes
- The
exec_time_optimization_effortandmemory_fitting_effortflags have been
removed in favor of theEffortLevelenum. - JAX does not support anymore deserialization of Exported modules from
before January 15th, 2026 because they are beyond the backwards compatibility
window. On that date we added support to serialize shardings as NamedSharding,
and now that is the only sharding serialization that is supported. - jnp.take_along_axis now always defaults wrap_negative_indices to True.
It used to default to False for mode=promise_in_bounds and True otherwise.
(This also means None is no longer a valid value for wrap_negative_indices.)
- The
-
Deprecations
- The fields
in_shardings_hloandout_shardings_hloof
jax.export.Exportedhave been deprecated for a while. Now accessing them
raises a warning. Usein_shardings_jaxandout_shardings_jaxinstead.
- The fields
-
Changes
- The cuDNN fused attention backward pass (used by
jax.nn.dot_product_attentionwithimplementation='cudnn') no
longer computes a bias gradient when the only attention bias comes from
a booleanmask, whose gradient no caller can request. Bias gradients
for an explicitbiasor a non-booleanmaskare unchanged
(#34685). jax.numpy.meshgrid,jax.numpy.ogrid, and
jax.numpy.broadcast_arraysnow return tuples rather than lists
in order to align with NumPy>2.0 and the Array API specification.
(#39783, #39789, #39802)- When
jax.gradorjax.value_and_gradrejects a function with
a non-scalar output, the error message now suggests reducing the output
to a scalar (e.g. withoutput.sum()), usingjax.jacobian, or
reshaping size-1 outputs (#2303). - When indexing with non-static or traced slice indices, the error message
now suggests usingjax.lax.dynamic_slice,
jax.lax.dynamic_update_slice, orjax.ds, and shows tracer
provenance (#7222). - PyTree metadata equality comparison failures now report the specific
registered pytree type that caused the error (#13027).
- The cuDNN fused attention backward pass (used by
-
Bug fixes
jax.numpy.linalg.detandjax.numpy.linalg.slogdetnow use a
closed-form LU decomposition with row pivoting for 2x2 and 3x3 matrices
instead of closed-form polynomial expansions to avoid numerical instability
and catastrophic cancellation (#39905).- The batching rules of the cuDNN fused attention primitives (used by
jax.nn.dot_product_attentionwithimplementation='cudnn') now
support operands that do not carry the vmap axis, including a shared
bias ormask. Previouslyjax.jacobian,jax.vmapwith partial
in_axes, andjax.vmapof a VJP or ofjax.gradfailed with a
reshapeTypeError(#38495). jax.vmapof fp8 cuDNN fused attention now works: its batching rules
additionally mislabeled or dropped the amax outputs and restored output
shapes incorrectly, so previously no vmap of the fp8 path succeeded at
all. The amax outputs are whole-batch statistics and do not carry the
vmap axis; vmap over the scale/descale operands raises a clear
NotImplementedError.- Setting
jax_compiler_enable_remat_passtoFalsenow adds
rematerializationto the set of disabled XLA passes instead of
overwriting it, so HLO passes disabled via
XLA_FLAGS=--xla_disable_hlo_passes=...stay disabled
(#37391). jax.numpy.split,jax.numpy.array_split, and the
hsplit/vsplit/dsplitvariants once again accept negative entries in
indices_or_sections, resolving them against the axis size as NumPy does
(#6599). Out-of-bound indices are now clipped to the axis
bounds and produce empty sections, also matching NumPy, instead of raising
ValueError: Sizes passed to split must be nonnegative.- Fixed abstract evaluation in
jax.lax.scanto only check.mat
equivalency when the abstract value is aShapedArray
(#39700). - Fixed propagation of singleton sharded dimensions in
jax.lax.reshape
when reshaping arrays with sharding constraints (#39309). - Fixed
jax.tree_util.flatten_one_level_with_keysfornamedtuple
instances (#39297). - Fixed
_get_prime_factorsinjax.experimental.mesh_utils
(#38286).