How Joomla Extension Update Sites Work

An extension update site is the source Joomla uses to discover new versions of an installed extension. The extension developer normally registers the source during installation, Joomla stores the relationship, and the Administrator can review it under System → Update → Update Sites. Understanding this flow makes missing-update and download problems much easier to diagnose.

The extension tells Joomla where its update metadata lives

An extension manifest can declare one or more sources inside an <updateservers> element. Joomla associates those update-server URLs with the installed extension. The source normally returns XML maintained by the developer.

There are two common update-server structures. An extension source describes releases for an individual extension. A collection source can point Joomla to definitions for multiple extensions. Packages and language collections are examples of situations where a collection can be useful.

Update metadata describes both the release and its requirements

The developer's XML can identify the extension, version, download location, target Joomla platform, minimum PHP version, supported database versions, changelog information, and package checksums or other release data.

When Joomla checks for updates, it parses that metadata and determines whether a newer release applies to the current site. A release can exist but be excluded because the current Joomla, PHP, or database version does not meet the metadata conditions.

Find Updates discovers releases; Update installs them

Go to System → Update → Extensions and select Find Updates. Joomla queries the enabled update sources and records valid applicable updates for the Administrator to review.

Discovery and installation are separate operations. Only after an administrator selects an available update and chooses Update does Joomla retrieve the package and run the extension installation/update process. This separation lets you inspect the version and changelog before changing the site.

Update Sites lets you inspect and manage the sources

Under System → Update → Update Sites, Joomla shows the registered update source, associated extension, and whether the source is enabled. Commercial extensions can also use Joomla's download-key mechanism when the developer implements it.

A disabled source normally will not participate in update discovery. If a known update does not appear, checking this screen is one of the first useful diagnostic steps. Do not replace a URL with one found on an unofficial mirror; an update source is part of the software supply chain.

Diagnose failures by separating discovery from package download

If Joomla cannot discover a release, investigate the update-site URL, enabled state, XML/metadata, compatibility filters, credentials, and the server's ability to reach the source. If Joomla discovers the update but fails after you press Update, the metadata may be readable while the actual package URL, authentication, checksum, extraction, or installation step is failing.

That distinction is valuable: “the update does not appear” and “the update appears but will not install” occur at different stages and should not be troubleshot as the same problem.


Need More Help with Joomla?

Still having trouble? Open a support ticket with QuantaCade Support and we'll be happy to help where we can.

Support priority is given to QuantaCade products, services, and customers. However, we're also happy to assist fellow Joomla users with general Joomla questions and troubleshooting when possible.

QuantaCade is an independent Joomla extension developer and is not official Joomla support. Some issues involving third-party extensions, hosting environments, server configurations, or other systems outside our development control may be beyond what we're able to resolve.

Open a Support Ticket