Installing a UXP panel (from a CCX file)

This page offers instructions on how to install a UXP panel locally from a downloaded CCX file (this apples to the new UXP version of Lumenzia). If you do not have Photoshop v23 or later, you will need to run the CEP version of Lumenzia (see here to install the older CEP version of Lumenzia). If you are trying to install Web Sharp Pro - that is also a UXP panel, but is distributed through the Adobe marketplace rather than as a standalone CCX file (see here to install through the Adobe Marketplace).

If you are installing a UXP panel purchased through the Adobe Marketplace (such as Web Sharp Pro), you will not have a CCX file and should instead follow the instructions for installing a UXP panel from the Adobe Marketplace.

Installing from a CCX file:

  • The Lumenzia ZIP file contains both the older CEP/Flash versions of Lumenzia and the newer UXP version. Just locate the file with the CCX file and double-click it.
  • DO NOT use "open with" or try to open the CCX file with either Photoshop or the Adobe installer. This will fail. The correct app is a hidden Adobe helper app (UPIA) that you wouldn't know about (it then loads the CCX in the Adobe installer, but that installer will not accept the file directly). If you have changed the default app, please see the steps below to change it back to the correct app.
  • This should open the Adobe Creative Cloud Desktop (CCD) installer and ask you to confirm you wish to install.
  • Go to the Plugins menu in PS if you do not automatically see the panel open in Photoshop (it won't show if Photoshop was closed during installation).

That's one of the main benefits of UXP, these panels are quite easy to install generally.

Note that if you have the CEP version of Lumenzia installed, it may be ideal (but is certainly not required) that you uninstall it or close it so that you free maximum resources for Photoshop. Simply closing it and restarting Photoshop gives you all the benefit, uninstalling it will save a tiny bit of extra space on your drive.

If you run into problems, please see the troubleshooting section below.

Troubleshooting

CCD says you do not have a compatible app installed:

The CCX file won't open or you get a warning "Creative Cloud cannot open files of this type." or "Could not complete your request because Photoshop does not recognize this type of file":

  • DO NOT try to open the CCX file via "open with" or by otherwise directing which app to open the CCX file. If the Adobe installer is properly installed, the correct helper app should automatically be used when you open the CCX via double-click (ie, don't try to outsmart the system).
  • This may indicate that you do not have the Creative Cloud Desktop app installed. If you have Photoshop CC, then you should have this.
  • This more likely may indicate that the CCX file extension is not pointing to the correct Adobe app. While the app you see is Creative Cloud Desktop, installing a local CCX file actually occurs through a helper app (UPIA: Unified Plugin Installer Agent). Make sure that your operating system is pointing to the correct app:

    MacOs: /Library/Application Support/Adobe/Adobe Desktop Common/RemoteComponents/UPI/UnifiedPluginInstallerAgent
    (it is likely a hidden folder, you can use cmd-shift-period to see hidden files if needed)

    Windows: C:\Program Files\Common Files\Adobe\Adobe Desktop Common\RemoteComponents\UPI\UnifiedPluginInstallerAgent
  • If you're still having trouble, please contact [email protected] to help understand why your system will not install a valid CCX

When I double-click, an app briefly opens and closes on screen - but CCD never opens to finish installing:

  • This likely is the UPIA (Unified Plugin Installer Agent) helper app opening and then failing to launch CCD. I've only had a few reports of this, but in one case the resolution was to move the CCX file to the desktop and then install from there. You may also try using the CCD repair feature (see the steps under guidance for error -2).
  • Try running UPIA from the command line. This should help at least show errors to understand the issue. Please see Adobe's list of error numbers (far down the page) to interpret any cryptic errors.
  • Make sure defensive or anti-virus software like Avast or Ashampoo are not blocking access to the folder where you've put the CCX file. Permissions errors tend not to result in clear error messages from UPIA.

I installed the panel, but cannot see it in Photoshop:

  • Go to the "Plugins" menu in Photoshop to launch any installed UXP panels (older CEP panels are under a different menu area: Window / Extensions)
  • Make sure you are running the latest version of Photoshop (my panels require PS v23 or later as of April 2022).
  • If it is installed in CCD (Creative Cloud Desktop) but does not show under the Plugins menu in Photoshop, you may need to repair CCD. See details to repair CCD below. ***

Adobe Creative Cloud : Error -2:

  • Make sure you have the CCX file on the same drive where Photoshop is installed (typically the boot drive) and then double-click it there.
  • Check that you have reasonable free space on the drive.
  • Try extracting the CCX to the desktop to ensure you aren't working from a preview or using a location with restricted permissions.
  • The most common cause of this error is a problem with permissions. Repairing the Adobe installer should help resolve the issue, see details below. ***
  • Reported to help by 1 person: On MacOS, try repairing disk permissions via Disk Utility / First Aid.
  • If the previous steps do not work, you may need to do a full reinstallation. Use the "uninstall" option and then reinstall Adobe Creative Cloud.
  • If still stuck, please see the "Still facing issues?" section at https://helpx.adobe.com/in/creative-cloud/kb/troubleshoot-common-addon-installation-issues.html#still-facing-issues to submit detail directly to Adobe for further help.

Adobe Creative Cloud : Error -10:

  • Make sure you have the CCX file on the same drive where Photoshop is installed (typically the boot drive) and then double-click it there.

For more detail on error messages from Adobe Creative Cloud installer:

*** To Repair CCD (Creative Cloud Desktop):

  • There is a repair option within the uninstall tool. Run "Uninstall Adobe Creative Cloud" located next to "Adobe Creative Cloud" app (on a Mac, these are both in Applications / Adobe Creative Cloud). Start the uninstaller, enter your password, and then click "REPAIR" instead of uninstall. This does not remove the installer or your Adobe apps.