Backward-incompatible changes in Adobe Commerce

Use this page to review high-level reference information for all backward-incompatible changes in each supported Adobe Commerce release. Backward-incompatible changes that have a major impact and require detailed explanation and special instructions are documented in the Backward-incompatible changes highlights.

We use a custom tool that extends a PHP semantic version checker to auto-generate this content. The tool compares the code base from a previous release with the code base from the latest release. Backward-incompatible changes for each release are aggregated into the following tables (if applicable):

Class changes
Class API membership changes
Database changes
Dependency injection (DI) changes
Interface changes
Interface API membership changes
Layout changes
System changes
XSD changes

To view changes in functional tests, refer to Backward incompatible changes in functional tests.

data-variant=info

data-slots=text

Patch releases are primarily focused on delivering security and quality enhancements on a regular basis to help you keep your sites performing at their peak. On an exceptional basis, breaking changes or additional patches or hotfixes may be released to address security or compliance issues and high-impact quality issues. On the module level, these are mostly PATCH-level changes; sometimes MINOR-level changes. See Release policy.

2.4.7 - 2.4.8

Adobe Commerce v2.4.8 includes the [B2B extension][] v1.5.2.

data-src=/includes/backward-incompatible-changes/commerce/2-4-7-2-4-8.md

2.4.6 - 2.4.7

Adobe Commerce v2.4.7 includes the [B2B extension][] v1.4.2.

data-src=/includes/backward-incompatible-changes/commerce/2-4-6-2-4-7.md

2.4.5 - 2.4.6

Adobe Commerce v2.4.6 includes the [B2B extension][] v1.3.5.

data-src=/includes/backward-incompatible-changes/commerce/2-4-5-2-4-6.md

2.4.4 - 2.4.5

Adobe Commerce v2.4.5 includes the [B2B extension][] v1.3.4.

data-src=/includes/backward-incompatible-changes/commerce/2-4-4-2-4-5.md

2.4.3 - 2.4.4

Adobe Commerce v2.4.4 includes the [B2B extension][] v1.3.3.

data-src=/includes/backward-incompatible-changes/commerce/2-4-3-2-4-4.md

[B2B extension]: https://experienceleague.adobe.com/en/docs/commerce-admin/b2b/reference/backward-incompatible-changes