How Releases and Patches Work

This topic applies to

Applies to

Commerce Web Stores


Both SuiteCommerce and SuiteCommerce Advanced (SCA) releases follow the same general release schedule. How these updates apply to your implementation depends on the Commerce application you are implementing:

  • SuiteCommerce – SuiteCommerce is delivered as a managed bundle. Therefore, all updates apply to your account automatically. Unless otherwise noted in the release notes, these updates require no further action.

  • SuiteCommerce Advanced – SCA implementations are delivered as unmanaged bundles. Therefore, you must manually migrate your account to the latest release to take advantage of any related features and updates. For more information on migrating SCA, see Update SuiteCommerce Advanced.

Starting with the 2019.2 release, both major and minor releases include specific release notes, indicating the new features or updates that apply. Releases prior to 2019.2 include release notes for major releases only. See SuiteCommerce and SuiteCommerce Advanced Release Notes for details.

Both of these Commerce offerings provide the following releases:

  • Major Releases

  • Minor Releases

Each release includes a version number using a nomenclature that is based on the semantic versioning schema, or SEMVER.

An example of release version nomenclature is 2019.1.1, as depicted in the following image.

What is a Major Release?

Major releases include significant product enhancements and new features or updates to both SuiteCommerce and SuiteCommerce Advanced applications. These releases occur approximately twice annually and are designated by the year of release. For example, 2019.1.

What is a Minor Release?

Minor releases include periodic updates to core source code for both SuiteCommerce and SuiteCommerce Advanced. These releases occur periodically within a major release cycle. Release notes explain any updates that have occurred. For example, 2019.1.1.

This topic applies to

Applies to

SuiteCommerce Advanced

What is a Patch?

Patches are documented instructions detailing how to implement a code update by manually customizing core SuiteCommerce Advanced source code. Patches are only available for SuiteCommerce Advanced implementations of Kilimanjaro and earlier.

If you are implementing the Kilimanjaro release of SCA or earlier and you do not want to migrate to the latest release of SCA, we provide patching instructions for some issues you may encounter with your implementation. See Patches for details.


Implementations of SuiteCommerce and the Aconcagua release of SCA and later do not require patching. SuiteCommerce implementations receive updates automatically. The best practice to update SCA (Aconcagua and later) is to migrate to the latest major or minor release.