---
schema_version: "1"
id: 12a0bd16cd6fb5d5566b69fb8aa638e6baefb215ccd5660bfa3d521eaa06ba54
title: Publishing Connectors to Exchange
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/mule-sdk/latest/publishing-connectors-exchange.md
canonical_url: https://docs.mulesoft.com/mule-sdk/latest/publishing-connectors-exchange
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 80c174f101ad9a19cd7c5e5c5cad77c9fe5749190090be9db3212fbb1e1898fb
description: MuleSoft Documentation Site
release: "1.13"
latest: true
---
---
product: Mule SDK
version: 1.13
is-latest-version: true
---

# Publishing Connectors to Exchange

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

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.

> [!NOTE] 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.

  ```xml
  <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.

  ```xml
  <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:

1.  Build your connector locally.

    ```console
    mvn clean install
    ```

2.  Verify that `mule-artifact.json` contains Java compatibility information.

    In your connector JAR file, confirm that `mule-artifact.json` includes the
    `supportedJavaVersions` attribute.

3.  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:

1.  Check your POM file for `mule-extensions-maven-plugin`.

2.  Ensure the version is 1.9.0 or higher.

3.  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.
