Publishing Connectors to Exchange

Starting August 1, 2026, publishing connectors and Mule plugins to Exchange requires Java compatibility metadata in mule-artifact.json when publishing new versions that change supported Java compatibility.

Exchange reads Java compatibility from mule-artifact.json during publication.

Update your connector configuration before publishing a new connector version. This change doesn’t affect connectors that are already published to Exchange.

Update Your Connector

Use the requirements that match your connector type:

Java connectors: Include the @JavaVersionSupport annotation when changing supported Java compatibility.
XML connectors: Update to mule-extensions-maven-plugin so Java compatibility metadata is generated at build time.

For XML connectors, choose the approach that matches your development setup:

If you use the parent POM, update to a parent version that includes mule-extensions-maven-plugin 1.9.0 or later.

<parent>
    <groupId>org.mule.connectors</groupId>
    <artifactId>mule-modules-parent</artifactId>
    <version>1.9.0</version> <!-- or later -->
</parent>

If you use Mule SDK, upgrade to a version that includes mule-extensions-maven-plugin 1.9.0 or later.

If you configure Maven plugins manually, update your POM file to reference mule-extensions-maven-plugin 1.9.0 or later.

<plugin>
    <groupId>org.mule.runtime.plugins</groupId>
    <artifactId>mule-extensions-maven-plugin</artifactId>
    <version>1.9.0</version> <!-- or later -->
</plugin>

Build Prerequisites

Maven 3.8.0 or later (3.9.8+ recommended)
JDK 17+ in the build pipeline

Verify Your Configuration

After updating your connector configuration:

Build your connector locally.
```
mvn clean install
```
Verify that mule-artifact.json contains Java compatibility information.

In your connector JAR file, confirm that mule-artifact.json includes the supportedJavaVersions attribute.
Test publishing to Exchange.

Publish to a test environment before publishing to production.

Troubleshooting

Publishing Fails After August 1, 2026

If Exchange rejects your connector with an error about missing Java compatibility information, verify your mule-extensions-maven-plugin version:

Check your POM file for mule-extensions-maven-plugin.
Ensure the version is 1.9.0 or higher.
Rebuild and republish your connector.

The Build Fails After You Update the Plugin

If the Maven build fails after you update to mule-extensions-maven-plugin 1.9.0 or later, use Maven 3.8.0 or later (3.9.8+ recommended) and JDK 17+ in your build pipeline.