---
schema_version: "1"
id: 4ed17c751f4b9838b1883b09e702e4757b81e06d3a7edf161854988a716eae57
title: DataWeave 2.12.0 Release Notes
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/release-notes/dataweave/dataweave-2.12.0-release-notes.md
canonical_url: https://docs.mulesoft.com/release-notes/dataweave/dataweave-2.12.0-release-notes
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 3eda3d48269aa303abfd54e627ad6d564dee60aa10fabe84fe1246bbf0db0d72
description: MuleSoft Documentation Site
latest: true
---
---
product: Release Notes
version: master
---

# DataWeave 2.12.0 Release Notes

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

This MuleSoft programming language simplifies data transformation tasks and serves as Mule runtime’s
expression language for configuring components and connectors. Build powerful integration solutions
with intuitive scripting capabilities.

For more detail, see [DataWeave Language](https://docs.mulesoft.com/dataweave/latest/).

## September 2026

DataWeave 2.12.3 is bundled with the Mule 4.12.3 release. The Mule patch release addresses these
DataWeave issues:

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>You can now configure the size of the DataWeave script parser cache by using the <code>mule.weave.script.parser.cache.size</code> system property.</p></div></div></td><td><div><div><p>W-23138851</p></div></div></td></tr><tr><td><div><div><p>A thread-safety livelock no longer occurs in the Java module builder and converter caches.</p></div></div></td><td><div><div><p>W-23652160</p></div></div></td></tr></tbody></table>

For details about the Mule release and patch updates, see
[Mule Runtime Engine 4.12.0 Release Notes](https://docs.mulesoft.com/release-notes/mule-runtime/mule-4.12.0-release-notes).

## August 2026

DataWeave 2.12.2 is bundled with the Mule 4.12.2 release. The Mule patch release addresses these
DataWeave issues:

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>The repeated attribute selector (<code>.*@</code>) now correctly preserves values when processing data structures containing empty map slots.</p></div></div></td><td><div><div><p>W-23457314</p></div></div></td></tr><tr><td><div><div><p>Type metadata processing now correctly handles sibling references that target the same type, preventing duplicate annotations.</p></div></div></td><td><div><div><p>W-23424037</p></div></div></td></tr><tr><td><div><div><p>DataWeave now handles Java Platform Module System (JPMS) access restrictions more gracefully when running on Java 17 and later in Mule runtime 4.6.0 and later.</p></div></div></td><td><div><div><p>W-23354139</p></div></div></td></tr><tr><td><div><div><p>The Jackson library is upgraded to 2.21.5.</p></div></div></td><td><div><div><p>W-23037592</p></div></div></td></tr><tr><td><div><div><p>The <code>per_app_java_bean_cache</code> compatibility flag now correctly reports its creation version as 2.9.</p></div></div></td><td><div><div><p>W-22417507</p></div></div></td></tr></tbody></table>

For details about the Mule release and patch updates, see
[Mule Runtime Engine 4.12.0 Release Notes](https://docs.mulesoft.com/release-notes/mule-runtime/mule-4.12.0-release-notes).

## July 2026

DataWeave 2.12.1 is bundled with the Mule 4.12.1 release. The Mule patch release addresses these
DataWeave issues:

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>Scope resolution errors no longer occur when importing Java classes with self-referential array properties.</p></div></div></td><td><div><div><p>W-22914494</p></div></div></td></tr><tr><td><div><div><p><code>StackOverflowError</code> errors no longer occur when computing or converting type metadata for self-referencing recursive types.</p></div></div></td><td><div><div><p>W-21712344</p></div></div></td></tr></tbody></table>

For details about the Mule release and patch updates, see
[Mule Runtime Engine 4.12.0 Release Notes](https://docs.mulesoft.com/release-notes/mule-runtime/mule-4.12.0-release-notes).

## June 2, 2026

DataWeave 2.12.0 is bundled with the Mule 4.12.0 release. For details about the Mule release, see
[Mule Runtime Engine 4.12.0 Release Notes](https://docs.mulesoft.com/release-notes/mule-runtime/mule-4.12.0-release-notes).

### What’s New

The 2.12.0 version of DataWeave introduces these new features and enhancements:

Scope Visibility:

- DataWeave now supports `private`, `internal`, and `@VisibleTo` annotations for controlling
  directive access. This enables better code encapsulation and visibility management across
  DataWeave modules. See
  [Scope Visibility in DataWeave](https://docs.mulesoft.com/dataweave/latest/dataweave-scope-visibility).

Component Metadata:

- DataWeave introduces `dw::meta::Component` and related component types for working with component
  descriptors. This provides enhanced metadata handling capabilities. See
  [Component (dw::meta::Component)](https://docs.mulesoft.com/dataweave/latest/dw-component) and
  [Component Types (dw::meta::Component)](https://docs.mulesoft.com/dataweave/latest/dw-component-types).

General Improvements:

- The [UNLIMITED\_CONTEXT](https://docs.mulesoft.com/dataweave/latest/dw-math-variables) math variable now has the
  `precision=0` and `roundingMode=HALF_UP` properties.

- The [Maven plugin for DataWeave](https://docs.mulesoft.com/dataweave/latest/dataweave-maven-plugin) now includes
  guidance for configuring cryptographic taint analysis during compilation.

- The [DataWeave extension plugin](https://docs.mulesoft.com/dataweave/latest/dataweave-extension-plugin) now provides
  editor support for scope visibility validation and diagnostics.

- DataWeave incorporates new system properties. See
  [DataWeave System Properties](https://docs.mulesoft.com/dataweave/latest/dataweave-system-properties).

### Compatibility

This table specifies which version of DataWeave is bundled with each Mule runtime engine release:

<table><colgroup><col> <col></colgroup><thead><tr><th>Mule Version</th><th>DataWeave Version</th></tr></thead><tbody><tr><td><p>4.13</p></td><td><p>2.13</p></td></tr><tr><td><p>4.12</p></td><td><p>2.12</p></td></tr><tr><td><p>4.11</p></td><td><p>2.11</p></td></tr><tr><td><p>4.10</p></td><td><p>2.10</p></td></tr><tr><td><p>4.9</p></td><td><p>2.9</p></td></tr><tr><td><p>4.8</p></td><td><p>2.8</p></td></tr><tr><td><p>4.7</p></td><td><p>2.7</p></td></tr><tr><td><p>4.6</p></td><td><p>2.6</p></td></tr><tr><td><p>4.5</p></td><td><p>2.5</p></td></tr><tr><td><p>4.4</p></td><td><p>2.4</p></td></tr><tr><td><p>4.3</p></td><td><p>2.3</p></td></tr><tr><td><p>4.2</p></td><td><p>2.2</p></td></tr><tr><td><p>4.1</p></td><td><p>2.1</p></td></tr><tr><td><p>3.9</p></td><td><p>1.2</p></td></tr><tr><td><p>3.8</p></td><td><p>1.1</p></td></tr><tr><td><p>3.7</p></td><td><p>1.0</p></td></tr></tbody></table>

### Fixed Issues

The release addresses these DataWeave issues and incorporates all patch updates from the 2.11.0
DataWeave release through May 2026:

<table><colgroup><col> <col></colgroup><thead><tr><th>Issue Resolution</th><th>ID</th></tr></thead><tbody><tr><td><div><div><p>DataWeave now supports the <code>private</code> modifier on <code>fun</code>, <code>var</code>, <code>ns</code>, and <code>type</code> declarations to hide them from importers.</p></div></div></td><td><div><div><p>W-21148967</p></div></div></td></tr><tr><td><div><div><p><code>internal</code> is no longer a reserved word and can now be used as an identifier in DataWeave scripts.</p></div></div></td><td><div><div><p>W-21508044</p></div></div></td></tr><tr><td><div><div><p>The compiler now reports an error when overloads of the same function declare different visibility modifiers.</p></div></div></td><td><div><div><p>W-21362539</p></div></div></td></tr><tr><td><div><div><p><code>StackOverflowError</code> no longer occurs in the type checker when resolving intersections of unbound type parameters.</p></div></div></td><td><div><div><p>W-20124753</p></div></div></td></tr><tr><td><div><div><p>Runtime errors no longer occur when invoking overloaded functions across modules.</p></div></div></td><td><div><div><p>W-21811015</p></div></div></td></tr><tr><td><div><div><p>Spurious type-check errors no longer occur when an optional key-value pair is assigned to a required one.</p></div></div></td><td><div><div><p>W-21351058</p></div></div></td></tr><tr><td><div><div><p><code>deferred</code> values passed to the <code>write</code> function now terminate correctly.</p></div></div></td><td><div><div><p>W-20925604</p></div></div></td></tr><tr><td><div><div><p>Out-of-memory errors no longer occur when reading large text or CDATA sections with the indexed XML reader.</p></div></div></td><td><div><div><p>W-21006104</p></div></div></td></tr><tr><td><div><div><p>The Java module bean introspection cache no longer causes memory leaks.</p></div></div></td><td><div><div><p>W-22419118</p></div></div></td></tr></tbody></table>

### Upgrade

This version of DataWeave is bundled with Mule. DataWeave upgrades take place through Mule. See
[Mule Upgrades and Patch Updates](https://docs.mulesoft.com/release-notes/mule-runtime/mule-esb#mule-upgrades).

## See Also

- [Salesforce Help](https://help.salesforce.com)

- [MuleSoft Services](https://www.mulesoft.com/support-and-services)

- [Troubleshooting a Failing DataWeave Script](https://docs.mulesoft.com/dataweave/latest/dataweave-troubleshoot)

- [Known Issues](https://help.salesforce.com/s/issues)