Update Release Policy and Publication Frequency for Composable Storefront Libraries

This document describes the update release policy and publication frequency for SAP Commerce Cloud, composable storefront.

Summary

  • SAP will publish update releases for the composable storefront on a continuous basis. These updates may contain bug fixes, feature updates, or a combination of both.

  • Update releases remain current for the following periods of time:

    • For SAP Commerce Cloud, composable storefront libraries, update releases remain current for six months after the publication of the core libraries, unless otherwise indicated.

      For example, the core composable storefront 2211.19 libraries were released in February 2024 and are considered current until August 2024.

    • For SAP Commerce Cloud, composable storefront, financial services accelerator libraries and SAP Commerce Cloud, composable storefront, telco and utilities accelerator libraries, update releases remain current for a minimum of six months after the publication of the libraries, including in this scope any core composable storefront libraries that the composable storefront, financial services accelerator libraries and composable storefront, telco and utilities accelerator libraries depend on.

  • A “roll-forward” approach is used, meaning only the latest update release of the libraries will receive bug fixes and new features.

  • Customers are strongly encouraged to regularly upgrade to the latest update release. A good rule of thumb is that, when you are upgrading SAP Commerce Cloud to a new version, it is recommended to use the same version of composable storefront. For example, when upgrading to SAP Commerce Cloud 2211.19, it is recommended that you also update composable storefront to version 2211.19.

Composable Storefront Releases and Compatibility Matrix

Composable Storefront

The following table lists the releases and compatibility matrix for core composable storefront libraries:

Releases Valid as Of Valid Until Supported SAP Commerce Cloud Releases

221121.10

April 21, 2026

October 21, 2026

2211-jdk21.4 to 2211-jdk21.10, as well as 2211.43 to 2211.51

221121.9

March 25, 2026

September 23, 2026

2211-jdk21.2 to 2211-jdk21.9, as well as 2211.43 to 2211.50

221121.7

February 20, 2026

August 31, 2026

2211-jdk21.1 to 2211-jdk21.7, as well as 2211.43 to 2211.49

221121.5

December 11, 2025

August 31, 2026

2211-jdk21.1 to 2211-jdk21.5, as well as 2211.42 to 2211.47

221121.4

November 17, 2025

August 31, 2026

2211-jdk21.1 to 2211-jdk21.4, as well as 2211.41 to 2211.46

221121.2

October 14, 2025

August 31, 2026

2211-jdk21.1 to 2211-jdk21.2, as well as 2211.39 to 2211.45

221121.1

September 9, 2025

August 31, 2026

2211-jdk21.1, as well as 2211.38 to 2211.44

2211.43

August 12, 2025

August 31, 2026

2211.37 to 2211.43

2211.42

July 8, 2025

January 13, 2026

2211.35 to 2211.42

2211.41

June 10, 2025

December 9, 2025

2211.33 to 2211.41

2211.39

May 13, 2025

November 11, 2025

2211.32 to 2211.39

2211.38

April 17, 2025

October 14, 2025

2211.31 to 2211.38

2211.37

March 14, 2025

September 9, 2025

2211.29 to 2211.37

2211.36

February 18, 2025

August 18, 2025

2211.28 to 2211.36

2211.32

December 10, 2024

July 24, 2025

2211.25 to 2211.33

2211.31

November 12, 2024

May 24, 2025

2211.24 to 2211.31

2211.29

October 8, 2024

April 24, 2025

2211.23 to 2211.29

2211.28

September 10, 2024

April 8, 2025

2211.21 to 2211.28

2211.27

August 13, 2024

April 8, 2025

2211.20 to 2211.27

2211.25

July 9, 2024

January 24, 2025

2211.20 to 2211.25

2211.24

June 11, 2024

December 24, 2024

2211.19 to 2211.24

2211.23

May 14, 2024

November 24, 2024

2211.16 to 2211.23

2211.21

April 9, 2024

October 24, 2024

2211.16 to 2211.21

2211.20

March 12, 2024

September 24, 2024

2211.13 to 2211.20

2211.19

February 20, 2024

August 24, 2024

2211.12 to 2211.19

6.8

January 16, 2024

July 24, 2024

2211.10 to 2211.17

6.7

December 12, 2023

June 24, 2024

2211.9 to 2211.16

6.6

November 14, 2023

May 24, 2024

2211.8 to 2211.15

6.5

October 10, 2023

April 24, 2024

2211.6 to 2211.13

6.4

September 12, 2023

March 24, 2024

2211.5 to 2211.12

6.3

August 8, 2023

February 24, 2024

2211.4 to 2211.10

6.2

July 11, 2023

January 24, 2024

2211.0 to 2211.9

6.1

June 13, 2023

December 24, 2023

2211.0 to 2211.8

6.0

April 21, 2023

October 24, 2023

2205*, 2211.0 to 2211.6

5.2

February 17, 2023

August 24, 2023

2105, 2205, 2211.0 to 2211.4

5.1

January 18, 2023

July 24, 2023

2105, 2205, 2211.0 to 2211.2

5.0

November 23, 2022

May 24, 2023

2105, 2205, 2211.0 to 2211.1

*If you are using SAP Commerce Cloud 2205 in combination with composable storefront 6.0, the end of support date for composable storefront 6.0 is May 18, 2024 (which corresponds with the end-of-life date for Angular 15). Release 2205 is not supported by releases published after June 2023 (6.1 or later). This exception only applies to composable storefront 6.0 being used with SAP Commerce Cloud 2205.

For more information about release dates of SAP Commerce Cloud, see Update Releases.

Composable Storefront, Telco and Utilities Accelerator

The following table lists the releases and compatibility matrix for composable storefront, telco and utilities accelerator libraries:

Releases of Composable Storefront, Telco and Utilities Accelerator Libraries Releases of Composable Storefront Libraries Supported SAP Commerce Cloud Releases Supported Telco and Utilities Accelerator Releases

230221.6

221121.9

2211-jdk21.9

2302-jdk21.6

230221.5

221121.7

2211-jdk21.7

2302-jdk21.5, 2302-jdk21.6

230221.4

221121.5

2211-jdk21.6

2302-jdk21.3

230221.3

221121.4

2211-jdk21.5

2302-jdk21.2

230221.2

221121.2

2211-jdk21.2

2302-jdk21.1

230221.1

221121.1

2211-jdk21.1

2302-jdk21.0

2302.9.1

2211.43

2211.43

2302.11

2302.9

2211.37

2211.37

2302.9

2302.4

2211.25 to 2211.32

2211.25 to 2211.32

2302.5 to 2302.8

6.0

6.0

2211.6

2302.1

5.0

5.0, 5.1, 5.2

2211

2302

Composable Storefront, Financial Services Accelerator

The following table lists the releases and compatibility matrix for composable storefront, financial services accelerator libraries:

Releases of Composable Storefront, Financial Services Accelerator Libraries Releases of Composable Storefront Libraries Supported SAP Commerce Cloud Releases Supported Financial Services Accelerator Releases

2302.7

2211.36

2211.28 to 2211.36

2302.6

2302.6

2211.31

2211.21 to 2211.31

2302.6

2302.4

2211.21

2211.16 to 2211.21

2302.4

2302.3

2211.19

2211.12 to 2211.19

2302.3

6.5

6.5 to 6.8

2211.12

2302.3

6.0

6.0

2211.6

2302.1

5.0

5.0

2211

2302

Composable Storefront, Citizen Engagement Accelerator

The following table lists the releases and compatibility matrix for composable storefront, citizen engagement accelerator libraries:

Releases of Composable Storefront, Citizen Engagement Accelerator Libraries Releases of Composable Storefront Libraries Supported SAP Commerce Cloud Releases Supported Citizen Engagement Accelerator (CEA) Releases

230321.0

2211.37 to 221121.5.0

2211-jdk21.5

2303-jdk21.1

2303.5.1

2211.29 to 2211.37

2211.37

2303.4

2303.5

2211.29 to 2211.37

2211.37

2303.4

2303.2

2211.29

2211.29

2303.1

Terms Used in this Document

  • “Maintenance” refers to fixes for identified bugs and security vulnerabilities.

  • “Functionality updates” refers to any change to how the product or services work or behave.

  • “Backwards-compatible update releases” are changes that include bug fixes and new functionality that are published in such a way that they do not require development work in the customer’s application, other than testing, when updating to this release.

  • “Incompatible changes” are changes included in an update that may require development work in the customer’s application, when upgrading, to ensure no functional regressions occurred.

  • “Semver” refers to Semantic Versioning, a convention for numbering JavaScript libraries. Semantic versioning will no longer be used for composable storefront release numbering. For more information, see Changes to Release Numbering and Update Policies for Composable Storefront Starting in February 2024. For more information on semver, see https://semver.orgInformation published on non-SAP site.

Background

The composable storefront is a set of libraries that enable customers to develop their own web applications for creating a state-of-the art storefront for headless SAP Commerce Cloud. The customer is responsible for developing and maintaining the web application. Though highly recommended, use of the composable storefront is optional.

The composable storefront extends the Angular framework through the introduction of new libraries that are designed to work with SAP Commerce Cloud. The libraries are delivered through SAP’s Repo-Based Shipment ChannelInformation published on SAP site. The composable storefront libraries are available to cloud customers only. Other customers may use project “Spartacus” open-source softwareInformation published on non-SAP site, which is synchronized with the official composable storefront libraries.

Frequency of Composable Storefront Update Releases

SAP will publish bug fixes and new features to composable storefront on a continuous basis, usually once per month, on the second Tuesday of the month. However, an update release may be published on an ad-hoc basis. This release strategy follows the principle of “one innovation code line” with subsequent update releases that ensure continuous innovation with an evolving code line.

A “roll-forward” approach to updates is used, which means that only the latest update release will receive bug fixes and new features.

A new update release of the composable storefront libraries may include the following:

  • Bug fixes that are backwards-compatible

  • New features that are backwards-compatible, through the use of feature flags when necessary

  • Features and bug fixes that are not backwards-compatible, requiring development work to update. This includes framework updates.

As described in Changes to Release Numbering and Update Policies for Composable Storefront Starting in February 2024, composable storefront will normally adhere to the following yearly update schedule:

  • Backwards-compatible bug fixes and new features from March to November

  • Bug fixes only in December and January

  • Framework and dependency updates every February, using the latest Angular framework that was published the previous quarter (usually in November).

Update Policy for Composable Storefront

A “roll-forward” approach to updates is used, which means that only the latest update release will receive bug fixes and new features. Older update releases do not receive bug fixes or features.

Customers are strongly encouraged to regularly schedule upgrades to the latest update release to mitigate risks and potential issues, such as but not limited to the following:

  • Not upgrading to a current update release of composable storefront exposes you to the risk of software defects, as well as performance, availability, functionality, or security issues.

  • Creating a new build of your application using an update release of composable storefront that is not current, may result in build errors -- as a result, you will be unable to deploy new code.

SAP provides technical support to SAP Commerce Cloud customers for releases that are current. When requesting support, customers will be asked to upgrade to the latest update release of the composable storefront software if they have not already done so, to determine if the issue was already resolved.

Example

  • A new framework update release was published in February 2024, numbered 2211.19. Note that numbering has changed from semantic versioning (6.x) to match SAP Commerce Cloud continuous release numbering (2211.*).

  • A month later, in March, 2211.20 (The “.20” may differ at time of publication) is released, containing new features and bug fixes that are backwards-compatible through feature flags or the use of components presence.

    Monthly releases containing new features and bug fixes continue from March until November. It is not guaranteed that every monthly release will contain new features.

    Exceptionally, an urgently required bug fix or compliancy update results in the publishing of 2211.20.1, between monthly releases. This is done only if it is urgent enough that the update cannot wait until the following monthly release (usually every second Tuesday of the month).

    December and January update releases are published but only with bug fixes, because preparation is under way for the February framework update release. The February release contains the newest Angular framework from the previous Q4. In 2025, this will likely be Angular 19.

    The cycle continues: new features from March to December, and so on.

Cloud Portal and Current Update Releases

Customers using the composable storefront must remain current by adopting a current update release as listed in the table at the top of this document.

For information on which update releases of SAP Commerce Cloud are current, see Update Releases.