New Exchange Requirements May Affect Your Listing

Erin Finnegan
Sep 25 · 7 min read

If you have an integration, add-on, or extension listed on the Adobe Exchange for Creative Cloud, please read on to find out how your listing(s) on the Exchange may be affected by a recent announcement regarding certain unauthorized software.

The list of unauthorized software was announced in May of 2019. Please refer to the official chart of unauthorized software here.

Going forward, this will affect Exchange listings in the following ways.

  • As of September 6th, new listings are no longer allowed to list compatibility for unauthorized products.
  • Beginning on November 8th, 2019, compatibility with unauthorized versions of Creative Cloud apps will be automatically hidden from Exchange listings.
  • After November 8th, 2019, listings that exclusively support unauthorized versions of software will be removed from the Exchange. Read on to find out how to update your listing to avoid removal.
  • Future listings may be rejected if they list compatibility exclusively with unauthorized products in the manifest.

Ideally, your product on the Adobe Exchange for Creative Cloud is already compatible with the two most recent releases of each Creative Cloud product you support. We recommend also joining the prerelease groups relevant to your product so you can test in advance of each release. Read about how to join different prerelease programs here.

Examples of affected listings

There are three types of Exchange listings that will be affected:

1. Listings that exclusively support unauthorized software

For example, if you support Photoshop 2015 as your maximum compatible version, your listing will be removed from the Exchange after November 8th of 2019 unless you submit an update before October 21st, instructions below.

2. Listings that support multiple Creative Cloud products, and one or more of the supported products has an unauthorized maximum version

For example, if you support a maximum of Illustrator 2018 and Photoshop 2015, the app with an unauthorized maximum version will be removed from your listing. In this case, Photoshop would be removed from your listing automatically.

In order to add Photoshop support back into your listing once it has been removed, you would need to start a new listing on the Exchange. However, if you update before October 21st, 2019, you may submit a patch rather than starting a new listing.

3. Listings that support many versions, including both authorized and unauthorized versions of Creative Cloud apps

If your app supports both authorized and unauthorized versions, you do not need to take any action at this time. However, unauthorized app compatibility will be hidden from Exchange users beginning in November.

For example, if your extension lists Photoshop 2015 as the minimum compatible version and no maximum version is specified, starting on November 8th, 2019, the Exchange will only list compatibility with Photoshop 2017 (18.1.7), 2018 (19) and 2019 (20), as those are the only authorized versions of Photoshop available at this time. (Version numbers are listed in this chart in the CEP Cookbook.)

How to update your listing

If you previously uploaded a .zip file to the Exchange, updating is easy; upload a new .zip file and choose newer versions of compatible products from the drop down menu. (Ideally, test your extension with the latest authorized software first.)

If you previously uploaded a .zxp file to the Exchange, you will need to update your manifest with authorized products as well as a new extension bundle version number (see the next section), and then upload a new .zxp file before October 21st.

Please note that you may not switch to a .zip file if you previously uploaded a .zxp.

Be sure to update your ExtensionBundleVersion number

Regardless of how you choose to update your extension, you will also need to update your ExtensionBundleVersion number.

For example, if your extension included this line:

<ExtensionManifest ExtensionBundleId="com.my.test" ExtensionBundleVersion="1.0.0" Version="9.0">

You would need to bump up the ExtensionBundleVersion like so:

<ExtensionManifest ExtensionBundleId="com.my.test" ExtensionBundleVersion="1.0.1" Version="9.0">

Note that in the example above, Version 9.0 refers to the CEP version.

Updating Your Manifest File

In order to keep your listing live, please update your manifest by doing one of the following:

  • Option A: Update the maximum version in your manifest to one of the two most recent major versions of the Creative Cloud products you support.
  • Option B: Remove the maximum version compatibility from your manifest, leaving only the minimum version. With only a minimum number, the Exchange will interpret your listing as having no maximum compatible version.

Manifest Examples

If your extension lists Photoshop 2015 as the maximum compatible version, it will be removed from the Exchange. Photoshop 2015 is version 16, as noted in the CEP Cookbook. The example below lists Photoshop 2014 (15.0) as the minimum compatible version and 2015 (16.0) as the maximum compatible version:

<HostList>
<Host Name=”PHSP” Version=”[15.0,16.0]” />
</HostList>

Only Photoshop 2019 (version 20) and 2018 (version 19) are currently authorized, so the listing above would be removed from the Exchange in November, unless the developer submits an updated manifest using either Option A or Option B below before October 21st:

  • Option A: The developer may choose to update the maximum compatible version:
    <Host Name=”PHSP” Version=”[18.1.7,20.9.9]” />
  • Option B: The developer may choose to remove the maximum version entirely, leaving only a minimum version:
    <Host Name=”PHSP” Version=”18.1.7" />

** Please note: If your listing already has no maximum, it will remain unchanged and you need not take any action at this time. That said, we recommend at least testing for compatibility with the latest releases.

Listings that support multiple Creative Cloud products

Please note: If your listing already supports at least one authorized version of each Creative Cloud product it is compatible with, you need not take any action at this time.

In our example below, the developer’s extension supports a maximum of Photoshop 2015 and Illustrator 2018. Photoshop 2015 is version 16, as noted in the CEP Cookbook. The example below lists Photoshop 2014 (15) as the minimum and 2015 (16) as the maximum compatible versions. This example is also compatible with Illustrator CC (17) as a minimum, and Illustrator 2018 (22) as a maximum:

<HostList>
<Host Name=”PHSP” Version=”[15.0,16.0]” />
<Host Name=”ILST” Version=”[17.0,22.0]”/>
</HostList>

Only Photoshop 2019 (20) and 2018 (19) are currently authorized, so Photoshop support would be removed from this listing on the Exchange, unless the developer submits an updated .zxp file before October 21st. Illustrator has no unauthorized versions, so in this example, Illustrator is unaffected.

In this case, the developer may choose to update the maximum compatible version for Photoshop, as in Option A above:

<Host Name=”PHSP” Version=”[18.1.7,20.9.9]” />
<Host Name=”ILST” Version=”[17.0,22.0]” />

Or, the developer may choose to remove the maximum version entirely, leaving only a minimum version, like in Option B above:

<Host Name=”PHSP” Version=”18.1.7" />
<Host Name=”ILST” Version=”[17.0,22.0]”/>

If the developer in this example failed to update their listing in time (by October 21st), Photoshop compatibility would be automatically removed from the listing after November 8th. In order to add Photoshop compatibility back into the listing, the developer would need to start a brand new listing on the Exchange.

Once again, please note that if your extension already supports authorized versions with no maximums, you need not take action at this time. For example:

<Host Name="AEFT" Version="15.0" />
<Host Name="PPRO" Version="12.1" />

The listing above has exclusively authorized minimum versions, so it is totally unaffected at this time.

Need more help?

If you require assistance updating your manifest, please contact Exchange Support. More documentation on manifest files can be found in the CEP Cookbook.

“But… what if my customers are not using the latest Creative Cloud apps?”

What if my customers are not using the latest Creative Cloud apps?

The change to download availability in the Creative Cloud desktop app may give you another opportunity to engage with your customers and help them update to the latest version(s) of available Creative Cloud products.

If your customers are still using unauthorized versions of Creative Cloud apps, encourage them to update as soon as possible.

Access to authorized legacy software

If, for any reason, you still need to download older authorized versions of Creative Cloud apps, please read the following list of options:

Please be aware that some legacy versions of apps are unauthorized and are no longer available.

You can help customers migrate to newer versions of their apps by delivering updates to your plugins and scripts as early as possible after a release. You can test against upcoming versions by building against the prerelease versions of our apps; apply for prerelease access here. For access to any apps not listed on the prerelease page, check the list in this article.


Again, if you have manifest questions or need help updating your extension, please contact Exchange Support. If you need help finding legacy versions of authorized apps, reach out to Adobe Support.


For the latest updates affecting developers, subscribe to our Creative Cloud Developer Newsletter.

Adobe Tech Blog

News, updates, and thoughts related to Adobe, developers, and technology.

Erin Finnegan

Written by

Community Engineer at Adobe. Views are my own.

Adobe Tech Blog

News, updates, and thoughts related to Adobe, developers, and technology.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade