Main Support

Troubleshooting failed update errors

When updating Joomla add-ons from Watchful, you may encounter this error:  

The update has failed. If the problem persists, please review the troubleshooting steps.

 This error may occur for a number of reasons including:

  • The update package may be corrupt.
  • The update package may not be compatible with your Joomla and/or PHP version.
  • The update package may not be available for download
  • For paid extensions using the Joomla updater (more common), your License Key/Download ID may no longer be valid, or updates for the extension may not be supported by the Watchful updater.
  • For paid extensions using a custom updater (less common), your License Key/Download ID may no longer be valid or the key may not be added on the remote site.

Use the instructions below to resolve the issue.

1. The update package may be corrupt or incompatible with your Joomla version.

To determine if the software vendor has a corrupt installer/updater, or if your Joomla site is not compatible, download the relevant package directly from the vendor website and attempt to install/update directly on the backend of the affected website.

If the install fails, please contact the vendor for further details/technical support. Otherwise, proceed to step 2.

2. The update package could not be downloaded.

For paid extensions, please skip immediately to step 3 to troubleshoot issues with invalid licenses/download IDs. 

For free extensions, please open a support ticket directly.

3. Your license key is not valid in Watchful.

Use the instructions below to troubleshoot issues with your License Key or Download ID for extension updates that are natively supported by Watchful. If this does not resolve the issue, please open a support ticket.

  • Obtain the license code, download ID, subscription key, etc... from your Joomla add-on vendor. Ensure that your subscription is still active.
  • View your account details by selecting the My Account link.
  • Enter the license key from step 1 in the appropriately labelled field, as indicated below.
  • Reapply the updates from your Dashboard.


4. Your license key is not valid on the remote site.

A small set of Joomla extensions use a custom update method. As a result, their license can not be stored centrally in Watchful. In these cases, add your License Key or Download ID for these extensions directly in the Joomla backend as appropriate for each extension (usually the Options for each extension).