Frequently Asked Questions

This section contains frequently asked questions about UXP. For Hybrid Plugin specific questions, see the Hybrid Plugins FAQ.

Questions

🛠️ Development Environment & Tooling

🎨 User Interfaces

📦 Installers and Packages

🇪🇺 EU Compliance & DSA Requirements

Answers

How can I enable Developer Mode?

You need to enable Developer Mode in both the UXP Developer Tool and your host application. Check your host application's own developer documentation for how to enable Developer Mode there.

In UDT, I get the error "Plugin Load Failed, Host Application specified is not available. Make sure the host application is started."

Make sure the host application specified in your plugin's manifest is running, and that Developer Mode is enabled in that host application.

How can I use Spectrum Web Components in my plugin?

You can use Spectrum Web Components in your plugin by following the instructions in the Spectrum Web Components reference.

Can I use React Spectrum instead of Spectrum Web Components?

Given that UXP does not support the entire set of HTML elements and CSS properties, React Spectrum components may not work as expected. For this reason, we recommend using React wrappers for Spectrum Web Components instead. Make sure you have enabled the enableSWCSupport feature flag in your manifest.json file and installed the right version of the components.

I am unable to install a plugin.

Refer to the troubleshooting section of Packaging Your Plugin for common installation issues.

My .ccx package is being rejected when submitted to the Creative Cloud Marketplace. What could be wrong?

Check whether the host property in your manifest.json is an object, not an array. If it's an array, validation will fail in production. See Manifest v5 for the correct host property structure.

Should I use an Array or an Object for the host property in the manifest.json?

The host property must be a single HostDefinition object for production. Arrays are only allowed during development for convenience. See Manifest v5 and Packaging Your Plugin for details.

Why is my plugin not visible in the EU region?

This could be due to incomplete or outdated trader information in your publisher profile. Make sure all required details are updated and accurate.

How can I update my trader details in the publisher profile after submission?

To update only your trader details in the publisher profile after submission, contact the developer distribution team through your host application's own developer support channel. Change requests for other fields in the publisher profile are not processed at this time.

An EU user with a deep link to your plugin will not be able to install it. They will see a banner with a message indicating the compliance issue.

Can an EU user still use my plugin if they have already installed it, but I am not compliant with the DSA trader requirements?

Yes. If an EU user has already installed your plugin, they can still use it even if you are not compliant with the DSA trader requirements. However, they will see a banner with a message indicating the compliance issue.