What version of Joomla! should you use?

From Joomla! Documentation

Revision as of 01:55, 29 June 2013 by Tom Hutchison (Talk | contribs)


Check for the latest Joomla! CMS version. If you are not on the latest release, read the release notes to see if you need to upgrade. If a release is being made in order to address security issues then it is strongly advised that you upgrade as soon as possible. You can see the release history of each series in the table below. Click the version history link in the notes column to find details on exact release date, release notes and package and MD5s.

  • Normally, you should use the latest version of Joomla! for a new site unless you have a specific reason not to.
  • The latest version can be downloaded from the Joomla! download site.
  • Make sure you subscribe to the Joomla! Security Announcements feed. This RSS feed is used to make announcements, including the availability of new releases, that could affect the security of your site. You have the option to subscribe to this feed by RSS or email.
  • If you are running an earlier release of the current version (for example, you are running 2.5.1 and the current version is 2.5.6), you should upgrade to the current version. Each minor release fixes a number of bugs and/or security issues. It is always good practice to upgrade to the latest maintenance version as a first step in troubleshooting a problem and fixing any newly discovered security issues.

Joomla! CMS versions

CMS Version Available Support End of Life Upgrade Type Notes Latest Release
Bugs Security
Sept 2012 Migration to 2.5 Plan to migrate to 2.5 now
Joomla 1.5 version history
EOL at 1.5.26
Aug 2011 One-click to 2.5 Upgrade to 2.5 now
Joomla 1.6 version history
Feb 2012 One-click to 2.5 Upgrade to 2.5 now
Joomla 1.7 version history
December 31st, 2014 One-click core to 3.x Start planning for an upgrade to 3.3.3
Joomla 2.5 version history
May 2013 One-click to 3.1 You should use the one click upgrade
Joomla 3.0 version history
Dec 2013 One-click to 3.2 You should use the one click upgrade
Joomla 3.1 version history
Oct 2014[1] One-click to 3.3 You should upgrade your server's PHP to 5.3.10 or greater and upgrade to 3.3
Joomla 3.2 version history
3.4 release One-click Recommended for all new installs
Joomla 3.3 version history
3.4[2] July 2014[2][3] - - 3.5 release One-click
3.5[2] Sept 2014[2][3] - - 3.6 release One-click
... ... ... ... ... ... ... ...
3.11[2] (Fall 2015)[2][3] - - ≥ Oct 2017[2] One-click Estimated EOL and last minor release on Joomla 3's roadmap
4.0 Q2 2015[3] - -

Joomla! versions explained

Stop hand nuvola.svg.png
Information is out of date

This information is out of date and being updated. The new development strategy is announced here, please read the full text of the development strategy for more information. This notice was modified on 30 Apr 2014.

Joomla! is developed using a fixed release cycle. Every six months, the Joomla! Project releases a new minor or major version of Joomla!. Joomla!'s version format is:


Each version of Joomla! is supported by the Joomla! Project for a limited amount of time. There are two classifications for support: short term support (STS) and long term support (LTS). Every fourth release will be assigned long term support.

  • STS (short term support) releases are supported for seven months. Their support ends one month after the next release of Joomla is released. They are one click upgrades to the next STS or LTS version.
  • LTS (long term support) releases are supported for twenty-seven months.

Please note that both STS and LTS releases, once they have reached the GA (General Availability) status, are fully functional and ready to be used in production environment. The disadvantage of using STS releases is that you will need to update your installation of Joomla! every six months, while the advantage is that you will have access to new features and extensions earlier.

Generally, the first STS release after an LTS release indicates the beginning of a new major release cycle. This STS release introduces fundamentally new features and changes that break compatibility with the previous LTS. Two more STS releases follow (usually compatible with the first STS release), and the release cycle is finished by the release of an LTS release which finalizes the work of the three STS releases. The four releases in one cycle will usually be numbered [major].0,[major].1 and [major].2 (STS) and [major].5 (LTS). For example, the STS release 3.0 will include breaking changes from 2.5, and 3.5 will include matured versions of the changes in 3.0, 3.1 and 3.2.

Usually, there will be a migration path (an officially supported way of migrating to the next version) between two LTS releases (from [major].5 to [next major].5) and between an LTS release and the STS releases in its major release cycle (from [major].2 to [major].5, for example), but not necessarily to the following STS releases (from [major].5 to [next major].0). In the case of 1.5 to 2.5 (LTS to LTS), for example, there is a migration path. Note that in the case of 2.5 to 3.0 (LTS to STS), there is also built-in migration path, since the changes aren't too incompatible.

For more information, see the official Development Strategy.

The latest STS version documented on this Wiki is 3.3.3 (see Category:Joomla! 3.3). The latest LTS version documented on this Wiki is 2.5.24 (see Category:Joomla! 2.5).

External Libraries

A Joomla! installation contain external libraries which are included with Joomla! CMS version releases. These external libraries are not part of the core code. Please read the Notes section as they may contain more information, such as a external library version change released with a maintenance release.

External Libraries by Joomla Release

CMS Version CMS Version Supported Mootools Mootools More jQuery jQuery UI
(Core, Widget, Mouse, Position, and Sortable)
Bootstrap Simple Pie PHP Mailer PHP UTF-8 IDNA Convert Rapid Application Development (RAD) Framework
Akeeba's Framework on Framework(FOF)
1.4.5[5] N/A[6] N/A[6] N/A[6] 1.2 5.2.1 0.5 N/A[6] N/A[7] N/A[8]
1.4.5 1.8.1 1.8.23 2.1.0 1.2 5.2.1 0.5 N/A[9] N/A[7] N/A[8]
1.4.5 1.8.3 1.8.23 2.1.0 1.2[10] 5.2.3 0.5 N/A[9] N/A[7] N/A[8]
1.4.5 1.8.3 1.8.23 2.3.2[11] 1.2[10] 5.2.6 0.5 0.8.0 N/A[7] N/A[8]
1.4.5 1.10.2[12] 1.9.2 2.3.2[11] 1.2[10] 5.2.6 0.5 0.8.0 2.1 1.0.3

References and Notes

  1. Bug fixes will cease April 2014, security fixes only, see

    "Also, for the six months after Joomla! 3.3 is released, the Joomla! Project will be releasing Security Updates for both 3.2 AND 3.3 (as well as 2.5) so any new vulnerabilities can be promptly patched with a one-click update without the need to immediately update to Joomla! 3.3, giving you time to request your hosting provider to update their PHP version."

  2. 2.0 2.1 2.2 2.3 2.4 2.5 2.6 See J3's roadmap for time frames of all future releases of all Joomla! 3 versions.
  3. 3.0 3.1 3.2 3.3 Please note that dates may be subject to change depending on availability of volunteers and circumstances beyond the PLT's control.
  4. This library is intended to provide forward compatibility with the password_* functions which were added to PHP 5.5. See [1] for further information. password_compat git
  5. Contains a 1.2 compatibility layer
  6. 6.0 6.1 6.2 6.3 Not applicable, this library was not included with Joomla! CMS version 2.5.
  7. 7.0 7.1 7.2 7.3 Not applicable, this library was not included with the Joomla! CMS prior to version 3.2. The version of FOF included in Joomla 3.2 is compatible with Joomla 2.5 however.
  8. 8.0 8.1 8.2 8.3 Not applicable, this library was not included with the Joomla! CMS prior to version 3.2
  9. 9.0 9.1 Not applicable, this library was not included with the Joomla! CMS prior to version 3.1.2.
  10. 10.0 10.1 10.2 This library was deprecated for JFeedFactory in Joomla! CMS version 3.1.0
  11. 11.0 11.1 Contains some 2.1 backward compatibility defaults
  12. Includes jQuery Migrate plugin 1.2.1 for backwards compatibility