Install a UXP plugin

Important Note!

Before you can connect to a UXP plugin running within Premiere Pro, you must enable 'Developer Mode', in Premiere Pro's Plugins preferences.

UXP plugins are commonly installed directly by the Creative Cloud Desktop application.

Overview

The installation options are slightly different depending on the distribution channel you are using—i.e., whether you are installing a plugin directly from the Creative Cloud Marketplace, a .ccx installer file obtained from independent channels, or deploying it in an enterprise environment.

data-variant=info

data-slots=heading, text

UXP Plugins in Premiere are found in the Window > UXP Plugins menu.

Use the Creative Cloud Marketplace

UXP plugins belong to the Stock & Marketplace category (left-hand sidebar) in the Creative Cloud Desktop application, Plugins tab (top navigation). The Plugins sidebar allows you to browse a curated list of "Featured plugins" or "All plugins".

To install a plugin of your choice, click the Get button on the plugin card.

A confirmation dialog will appear, informing you about the permissions the plugin needs (the ones that developers have declared in the plugin's manifest); click OK to confirm the installation.

If everything goes to plan, the plugin will be available in the "Manage Plugins" section of the Creative Cloud Desktop application, as well as in the host application. For Premiere, it will be the Window > UXP Plugins menu.

Use a .ccx installer file

If you have developed or acquired a UXP plugin from a third-party, you can install it by double-clicking on the .ccx file. If not already open, the Creative Cloud Desktop application will launch. You will be prompted with an additional warning dialog since the plugin doesn't come from the Creative Cloud Marketplace; click on the Install button to continue.

Depending on the specific access level the plugin requires (for example, to the Network or the Local FileSystem—see this section of the Manifest reference for more details), users may need to grant administrative privileges to the plugin.

Once the installation is complete, the plugin will be available in the Plugins section of the Creative Cloud Desktop application application, as well as in the host application. For Premiere, it will be the Window > UXP Plugins menu.

If the installation fails, click the Details link on the red toast to open the Logs and check the error message. See Troubleshooting for more details.

Uninstall a Plugin

In the Creative Cloud Desktop application, "Manage Plugins" tab, right-click on the ••• icon within a plugin card and select Uninstall to delete it. There's also the option to Disable the plugin, which will remove it from the host application but keep it installed in the Creative Cloud Desktop application. Both actions will pop a confirmation dialog.

data-variant=info

data-slots=text, text2

Use the UPIA tool

Under the hood, the Creative Cloud Desktop application uses a command-line utility called the Unified Plugin Installer Agent (UPIA) to manage UXP plugins. Please refer to the UPIA tool documentation for a detailed usage guide for both macOS and Windows.

The UPIA tool can install, uninstall, and list plugins. Here's a quick summary of the available commands.

On macOS

Open the Terminal and cd to the UPIA executable folder—admin privileges may be required:

cd "/Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent/UnifiedPluginInstallerAgent.app/Contents/macOS"

./UnifiedPluginInstallerAgent --help
./UnifiedPluginInstallerAgent --version
./UnifiedPluginInstallerAgent --install <extension-file-path>
./UnifiedPluginInstallerAgent --remove <extension-file-path>
./UnifiedPluginInstallerAgent --list <all || product display name>

A few examples:

./UnifiedPluginInstallerAgent --install "~/Desktop/Test-xjluvc_premierepro.ccx"
./UnifiedPluginInstallerAgent --remove "startup-test"
./UnifiedPluginInstallerAgent --list all

On Windows

Open the Command Prompt, type this command and press Enter:

cd "C:\Program Files\Common Files\Adobe\Adobe Desktop Common\RemoteComponents\UPI\UnifiedPluginInstallerAgent"

Here's a list of the available commands—admin privileges may be required:

UnifiedPluginInstallerAgent.exe /help
UnifiedPluginInstallerAgent.exe /version
UnifiedPluginInstallerAgent.exe /install <extension-file-path>
UnifiedPluginInstallerAgent.exe /remove <extension-file-path>
UnifiedPluginInstallerAgent.exe /list <all || product display name>

A few examples:

UnifiedPluginInstallerAgent.exe /install "C:\Temp\Test-xjluvc_premierepro.ccx"
UnifiedPluginInstallerAgent.exe /remove "startup-test"
UnifiedPluginInstallerAgent.exe /list all

Troubleshooting

While UXP plugins are generally very reliable in terms of management, occasional issues may arise.

• It is helpful to run the host application at least once before installing any plugin.
• If the Creative Cloud Desktop application is not launching when you double-click on a .ccx file, try locating the UPIA executable and running it manually. The file extension may not have been associated properly, or there might be permission issues.
• It may happen that the UPIA executable is either corrupted or not present in the system. Reinstalling the Creative Cloud Desktop application may resolve the issue. If you are installing plugins in an enterprise environment, please check here how to include the UPIA in your package.
• Try using Anastasiy's Extension Manager (third-party tool) to install the plugin.
• Reach out to ccintrev@adobe.com for support. If further troubleshooting is necessary, you may be asked to run the Log Collector tool.