Upgrading Versions

From Joomla! Documentation

Revision as of 20:30, 8 September 2013 by Tom Hutchison (Talk | contribs)

Before you begin, it is essential you know what version of Joomla! you are using. This is especially true if you are changing a major version. If you are already confused or don't know what a major version is, you should read more about the release and support cycle of Joomla! CMS Versions.

A Brief Summary

Joomla! is released with the following version designations, [major].[minor].[maintenance]. So version 3.1.5 is Joomla! major version 3, minor 1, and maintenance release 5. Since version 1.7, the updating and upgrading of Joomla! are built into the administration interface as a component. The terms updating and upgrading might be used interchangeably. In many ways, updating and upgrading are alike, but you should pay very close attention to the details of an upgrade. Upgrades would be defined as a major.minor(2.5) to a different major.minor(3.1) version or a major.minor(3.0) to a minor(3.1).

Simple Updating

Updates are an easy update to the next maintenance release, for example version 2.5.13 to version 2.5.14. This would be a maintenance release of the 2.5 version.

Updating your version of Joomla! CMS 3.5
Updating your version of Joomla! CMS 2.5


Before you upgrade, you will have to do some homework. You will need to gather information which will include the following:

  • Template compatibility - Will your current template work with the new version? You will have to contact the template builder to verify this information.
  • Installed extensions compatibility - Make a list of installed extensions, modules and plugins. Will they work with the new version? Does the developer have a version compatibile or at the very least is there a comparable extension.
  • Will the positions of modules change? Some template developers may have upgraded a template to the next version, but may have changed the module positions or added more.
  • Should this be a 'live'(www viewable) upgrade? This question is a tough one and only you will know the type of upgrade you should perform. It may be better to do a 'offline'(localhost, subdomain or subfolder) upgrade, make sure your site is working fine, then move the new version to the 'live' location.
Stop hand nuvola.svg.png
Just Remember!

Above all, realise without the correct preparation and knowledge, you may break your 'live' site.

Upgrading to J3.1

Upgrading 1.6.5, 1.6.6, 1.7.x, 2.5.x to 3.x is covered by the following page.

Upgrading to Joomla! CMS version 3.5

Upgrating to J2.5

Upgrading 1.6.5, 1.6.6, 1.7.x, to 2.5 is covered by the following page.

Upgrading to Joomla! CMS version 2.5

Upgrading from 1.6.x(not 1.6.5 or 1.6.6 Versions)

You must upgrade to Version 1.7 first if you are on version of 1.6 below the maintenance release of 1.6.5.

Upgrading Version 1.6.5 or 1.6.6 to Version 1.7


If you are using Version 1.5 this requires a migration because of Database changes.