This page explains Drupal’s version numbering scheme for both Drupal core and contributed modules. It is designed to help you understand what the various version numbers mean and how you can use this information when building a Drupal site.
Which version of Drupal core should I install?
In brief, you should always run one of the recommended official releases. These can be found at the Drupal Project page.
At any given time, there are two major release series of Drupal which are supported. Currently, these are Drupal 7 and Drupal 8. Updated versions of each of these are issued on a regular basis. For example, within the Drupal 7 series, several versions have been and will continue to be released: 7.0, 7.1, 7.2, etc. These versions are sometimes collectively referred to as “7.x”; however, they are not all equal. The newest version in each series fixes problems that were discovered since the previous version, and these fixes sometimes include critical security updates. Thus, regardless of whether you are using Drupal 7 or 8, you should always run the most current version in the series.
In deciding between Drupal 7 and Drupal 8, several factors should be taken into consideration. Drupal 8 is newer, will be supported longer, and contains more features and enhancements than Drupal 7; therefore, if all else is equal, use Drupal 8. However, the releases of contributed modules, themes, translations, and installation profiles compatible with each major Drupal release series sometimes lag behind Drupal itself, so if the functionality you need is not yet available for Drupal 8, this may affect your decision.
To read more about Drupal 8, see Drupal 8.0.
Which version of contributed modules, themes, and translations should I install?
You usually should run one of the “official releases” from the module, theme, or translation’s project page, because these are the versions that are currently supported by the maintainer. Note that when examining a particular release available on these pages, the first part of the version number shows you which major release series of Drupal core a module, theme, or translation is compatible with. For example, a module with a version number of 7.x-1.2 will only work with Drupal 7, whereas a module with a version number of 8.x-1.2 will only work with Drupal 8.
When is the next release?
New stable releases of Drupal core are scheduled to occur within particular release “windows“:
- A bug fix/feature release window is on the first Wednesday of each month.
- A security release window is on the third Wednesday of each month.
A release window does not necessarily mean that a release will actually be made on that date, but it exists so that site administrators can know in advance which days they should be on the look out for one.
In the particular case of bug fix/feature releases, a new release will only come out if it’s deemed by the Drupal core maintainers to contain enough important bug fixes or features to warrant a release. If a release is warranted, a “code freeze“ will be called a few days prior to the release date, and the impending release will be announced via the @drupal Twitter account and Planet Drupal. This is a good time to update to the latest code in the branch for your version of Drupal, and help make sure the code is solid.
Security release windows are handled via a separate process, and the final decision to make or not make a core release during a particular release window is made in private by the Drupal security team and only announced once the security fix is in place and the release is available for download.
Exceptions to the above schedule may be made in case of security vulnerabilities being actively exploited in the wild, severely critical bugs that prevent Drupal from being used, holidays, etc. When appropriate, changes will be announced in advance via Planet Drupal (and also via the Drupal core group).
How do I know which version of Drupal I’m running?
If it’s available, go to Administer (or Administration) > Reports > Status report. This will list your version number if you have Drupal 6.0 or later. In Drupal 5.x and earlier, the path to go to is Administer > Logs > Status report.
Failing that, look for a file called CHANGELOG.txt in the root of your Drupal directory and open it up to find the version you are running.
If CHANGELOG.txt is missing, you can also check in includes/bootstrap.inc for a line at the top like:
Before Drupal 7 this was in modules/system/system.module
If one of these is present, it will tell you which version you are running. If not, you have a version earlier than 4.7.2.
How do I know which version of a module or theme I’m running?
You can see the versions of your installed modules and themes on the modules and themes administration screens. In Drupal 7, go to Administration > Modules or Administration > Appearance, and you will see a column listing the version number. (In Drupal 6, the equivalent pages can be found at Administer > Site building > Modules and Administer > Site building > Themes.)
What about upgrading and backwards compatibility?
For more details about upgrading and backwards compatibility, read this overview of Drupal’s philosophy on backwards compatibility.
The pages below have some more details for advanced users.