Sitecore Versioning Policy


Description

Sitecore's versioning policy is aligned with the wider software industry. Our definitions in these areas, including the notion of a feature release, an update, and a hotfix, are described here.

Feature Release

A feature release adds significant functionality to a product.

Sitecore encourages customers to use new feature releases when they have projects that require the functionality that is added in a release.

Sitecore names feature releases with a unique two-level version number.

For example: Sitecore Experience Platform 10.0.

Update

An update resolves a set of issues associated with a specific product version.

Sitecore encourages customers to always install latest update to ensure latest fixes are included in their solution. It is important to note that updates are cumulative — Update-2 of a version contains everything that was in Update-1.

Starting from Sitecore 10, updates do not introduce breaking changes, behavior changes, or new features. If a breaking change needs be introduced, e.g. for security reasons, it would be disabled by default and customer would have to enable it specifically in configuration.

Sitecore names updates with a two-level version number that matches the corresponding feature release, and a label that specifies the update number.

For example: Sitecore Experience Platform 10.1 Update-1.

Hotfix

To resolve support issues that are identified as bugs in the product, Sitecore Support will work with the customer to determine the best way to address the issue.

In some situations when no workaround for the product bug is available, Sitecore may provide individual customers with a hotfix to resolve a specific issue identified as part of the investigation.

All hotfixes delivered by Sitecore undergo the full quality assurance cycle and are commonly delivered within the 4 weeks' timeframe.

Hotfixes provided by Sitecore Support may be cumulative meaning they include changes from hotfixes previously created for other Sitecore customers.

Fixes included into a Sitecore hotfix are also eventually included into a public Update or Feature Release.

Customers should only apply hotfixes if they are experiencing a specific issue the hotfix is addressing. Additionally, before applying a hotfix, customers should always confirm with Sitecore Support its compatibility with their Sitecore version, as well as for potential conflicts with other installed hotfixes.

Starting from Sitecore XP 10.1, Sitecore distributes pre-releases of the next update release to provide customers with fixes for their hotfix requests. For more details about pre-releases, refer to Sitecore XP pre-releases.

Customers might request pre-releases from Sitecore Customer Support if they are available.

Naming example for Sitecore hotfix packages looks like this:

SC Hotfix 156031-1 CMS.Core 10.0.4
Sitecore CMS 8.1 rev. 151207 Hotfix 148802-1
Sitecore 10.1.2 rev. 006059 PRE (DELTA WDP XM1 packages)

Historical Notes