From 356b0db55807963b46234cda645b147d8a013962 Mon Sep 17 00:00:00 2001
From: Dima Shevtsov <shevtsov@adobe.com>
Date: Fri, 6 Mar 2026 19:10:21 -0600
Subject: [PATCH 1/5] Document major backward-incompatible changes introduced
 in Adobe Commerce and Magento Open Source 2.4.9-beta, including GraphQL
 validations, new 2FA blocks, New Relic migration, Symfony 7.4 support, Valkey
 CLI command, and Zend_Cache replacement with symfony/cache.

---
 .../backward-incompatible-changes/index.md    | 129 ++++++++++++++++++
 1 file changed, 129 insertions(+)

diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md
index ff07b53f2..d7bf599e2 100644
--- a/src/pages/development/backward-incompatible-changes/index.md
+++ b/src/pages/development/backward-incompatible-changes/index.md
@@ -9,6 +9,135 @@ keywords:
 
 This page highlights backward-incompatible changes between Adobe Commerce and Magento Open Source releases that have a major impact and require detailed explanation and special instructions to ensure third-party modules continue working. High-level reference information for all backward-incompatible changes in each release is documented in the [reference](reference.md) section.
 
+## 2.4.9-beta
+
+The following major backward-incompatible changes were introduced in the 2.4.9-beta Adobe Commerce and Magento Open Source releases:
+
+* GraphQL alias limit validation
+* GraphQL query length validation
+* New 2FA blocks for identity verification
+* New Relic migration from REST v2 to NerdGraph
+* Symfony 7.4 LTS support
+* Valkey 8.x CLI command
+* Zend_Cache replaced with symfony/cache
+
+### GraphQL alias limit validation
+
+Validation was added to limit the number of aliases in GraphQL requests to prevent denial of service or resource degradation from excessive aliases. Previously, there was no limit on the number of aliases in a GraphQL request.\<!--AC-14701--\>
+
+**Impact:**
+
+* Only custom or non-standard clients that send a large number of aliases in a single request may be affected
+* Standard storefront and supported integrations are not expected to be impacted
+* The default maximum number of aliases is 10
+
+**Action required:**
+
+Configure the alias limit in the Admin: **Stores** > **Configuration** > **Services** > **Magento Web API** > **GraphQL Input Limits**:
+
+* **Enable Maximum Alias Limit** (Yes/No)
+* **Maximum Alias Allowed**
+
+### GraphQL query length validation
+
+A new configuration enables validation of GraphQL query length before processing. Queries exceeding the allowed limit are rejected to prevent denial of service and system crashes from oversized queries.\<!--AC-16203--\>
+
+**Impact:**
+
+* Only custom or non-standard clients using very large GraphQL queries may be impacted
+* No impact is expected on normal storefront usage
+* The default limit is 1,048,576 characters (~1 MB). Typical Magento GraphQL queries are usually in the range of a few kilobytes
+* The limit can be disabled or increased in configuration if needed
+
+**Action required:**
+
+No action is required for typical usage. To adjust the limit, use the system configuration path `webapi/graphql_validation/query_length_limit_enabled` and related options in **Stores** > **Configuration** > **Services** > **Magento Web API** > **GraphQL Input Limits**.
+
+### New 2FA blocks for identity verification
+
+New blocks were added to allow admin users to configure multiple two-factor authentication (2FA) providers by verifying identity with an already configured 2FA method or by validating an email link. This streamlines the 2FA configuration flow.\<!--AC-14709--\>
+
+**Impact:**
+
+* Affects admin login when 2FA is enabled
+* Applicable for all admin users using 2FA
+* No negative impact; the change improves the configuration experience
+
+**Action required:**
+
+No action is required for merchants or partners.
+
+The following module is affected by this change:
+
+* [Magento_TwoFactorAuth](/module-reference/module-two-factor-auth/)
+
+### New Relic migration from REST v2 to NerdGraph
+
+The New Relic integration was upgraded from REST API v2 to NerdGraph (GraphQL-based API) because REST API v2 is being deprecated by New Relic. NerdGraph offers enhanced deployment tracking, richer metadata, and more secure, granular permissions.\<!--AC-15831--\>
+
+**Impact:**
+
+* Configuration changes in the Admin (new fields added)
+* Merchants need to update their New Relic configuration settings once
+* No breaking changes to existing functionality; backward compatibility is maintained during transition
+* Deployment marker functionality now uses NerdGraph API alongside REST API v2
+
+**Action required:**
+
+Update New Relic configuration in the Admin:
+
+1. Go to **Stores** > **Configuration** > **General** > **New Relic Reporting**
+1. Set **API Mode** to **NerdGraph API**
+1. Enter **NerdGraph API URL**: `https://api.newrelic.com/graphql`
+1. Get **Entity GUID** from the New Relic dashboard and enter it
+1. Update to **User API Key**
+
+The following module is affected by this change:
+
+* [Magento_NewRelicReporting](/module-reference/module-new-relic-reporting/)
+
+### Symfony 7.4 LTS support
+
+Adobe Commerce 2.4.9 adds support for the latest Symfony 7.4 LTS version. This is a major change in the Semantic Version Checker and affects framework dependencies.\<!--AC-16188--\>
+
+**Impact:**
+
+* Custom classes that extend Symfony core classes must have updated type declarations and method signatures aligned with Symfony 7.4
+* Ensures long-term compatibility with PHP 8.x and future framework updates
+* No negative impact when custom code is aligned with the new requirements
+
+**Action required:**
+
+Ensure that all custom classes extending Symfony core classes have updated type declarations and method signatures aligned with the latest Symfony requirements before upgrading to Adobe Commerce 2.4.9. This prevents compatibility issues and ensures a smooth transition.
+
+### Valkey 8.x CLI command
+
+A dedicated CLI command was added to configure and enable Valkey 8.x, minimizing confusion between Valkey and Redis and displaying Valkey-specific constants.\<!--AC-14631--\>
+
+**Impact:**
+
+* No feature behavior change; this adds a new CLI option for Valkey configuration
+* No negative impact on existing customers
+
+**Action required:**
+
+No action is required for existing customers. Use the new CLI command when configuring Valkey instead of Redis.
+
+### Zend_Cache replaced with symfony/cache
+
+The deprecated Zend_Cache implementation was replaced with the `symfony/cache` component. Symfony/cache is actively maintained and improves cache management performance, maintainability, and compatibility with PHP 8.x and future framework updates.\<!--AC-16067--\>
+
+**Impact:**
+
+* All cache operations are affected: default cache and full-page cache (FPC) now use Symfony adapters instead of Zend Cache
+* Improved tag-based invalidation and cache cleaning across all cache types (config, layout, block_html, collections, EAV, compiled config, and others)
+* The change is transparent and backward compatible—existing cache commands (`cache:flush`, `cache:clean`) work identically but run 30–50% faster with reduced Redis load
+* Custom code that extended or replaced Zend Cache classes or interfaces may need to be updated to use Symfony cache adapters
+
+**Action required:**
+
+Existing customers can upgrade to Adobe Commerce 2.4.9 without configuration changes. For the Symfony cache implementation, additional parameters (such as igbinary, php-redis) are documented in the cache documentation and are recommended for performance. Extensions that depend on Zend_Cache classes or interfaces must be updated to use the corresponding Symfony cache APIs.
+
 ## 2.4.8
 
 The following major backward-incompatible changes were introduced in the 2.4.8 Adobe Commerce and Magento Open Source releases:

From 7546aae697d01f60b5562fb5fabcf20caa85c9c1 Mon Sep 17 00:00:00 2001
From: Dima Shevtsov <12731225+dshevtsov@users.noreply.github.com>
Date: Mon, 9 Mar 2026 10:58:16 -0500
Subject: [PATCH 2/5] Update
 src/pages/development/backward-incompatible-changes/index.md

Co-authored-by: chernenm <88728158+chernenm@users.noreply.github.com>
---
 src/pages/development/backward-incompatible-changes/index.md | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md
index d7bf599e2..11463c71e 100644
--- a/src/pages/development/backward-incompatible-changes/index.md
+++ b/src/pages/development/backward-incompatible-changes/index.md
@@ -78,7 +78,6 @@ The New Relic integration was upgraded from REST API v2 to NerdGraph (GraphQL-ba
 **Impact:**
 
 * Configuration changes in the Admin (new fields added)
-* Merchants need to update their New Relic configuration settings once
 * No breaking changes to existing functionality; backward compatibility is maintained during transition
 * Deployment marker functionality now uses NerdGraph API alongside REST API v2
 

From e3ad09e594ba5b257d3bd2467cc749f68b3fc39e Mon Sep 17 00:00:00 2001
From: Margaret Eker <meker@adobe.com>
Date: Mon, 9 Mar 2026 11:36:24 -0500
Subject: [PATCH 3/5] Apply suggestions from code review

---
 .../backward-incompatible-changes/index.md         | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md
index 11463c71e..06224e6ae 100644
--- a/src/pages/development/backward-incompatible-changes/index.md
+++ b/src/pages/development/backward-incompatible-changes/index.md
@@ -11,7 +11,7 @@ This page highlights backward-incompatible changes between Adobe Commerce and Ma
 
 ## 2.4.9-beta
 
-The following major backward-incompatible changes were introduced in the 2.4.9-beta Adobe Commerce and Magento Open Source releases:
+The following major backward-incompatible changes were introduced in the 2.4.9-beta1 Adobe Commerce and Magento Open Source releases:
 
 * GraphQL alias limit validation
 * GraphQL query length validation
@@ -23,17 +23,17 @@ The following major backward-incompatible changes were introduced in the 2.4.9-b
 
 ### GraphQL alias limit validation
 
-Validation was added to limit the number of aliases in GraphQL requests to prevent denial of service or resource degradation from excessive aliases. Previously, there was no limit on the number of aliases in a GraphQL request.\<!--AC-14701--\>
+Validation was added to limit the number of aliases in GraphQL requests to ten. This limit prevents denial of service or resource degradation from excessive aliases. Previously, there was no limit on the number of aliases in a GraphQL request.\<!--AC-14701--\>
 
 **Impact:**
 
-* Only custom or non-standard clients that send a large number of aliases in a single request may be affected
+* Only affects custom or non-standard clients that send a large number of aliases in a single request
 * Standard storefront and supported integrations are not expected to be impacted
 * The default maximum number of aliases is 10
 
 **Action required:**
 
-Configure the alias limit in the Admin: **Stores** > **Configuration** > **Services** > **Magento Web API** > **GraphQL Input Limits**:
+Configure the alias limit in the Admin from **Stores** > **Configuration** > **Services** > **Magento Web API** > **GraphQL Input Limits**:
 
 * **Enable Maximum Alias Limit** (Yes/No)
 * **Maximum Alias Allowed**
@@ -59,8 +59,8 @@ New blocks were added to allow admin users to configure multiple two-factor auth
 
 **Impact:**
 
-* Affects admin login when 2FA is enabled
-* Applicable for all admin users using 2FA
+* Affects Admin login when 2FA is enabled
+* Applicable for all Admin users using 2FA
 * No negative impact; the change improves the configuration experience
 
 **Action required:**
@@ -89,7 +89,7 @@ Update New Relic configuration in the Admin:
 1. Set **API Mode** to **NerdGraph API**
 1. Enter **NerdGraph API URL**: `https://api.newrelic.com/graphql`
 1. Get **Entity GUID** from the New Relic dashboard and enter it
-1. Update to **User API Key**
+1. Update the **User API Key**
 
 The following module is affected by this change:
 

From ed7599614a7145d30010f59700f12bfe39bd0d93 Mon Sep 17 00:00:00 2001
From: Margaret Eker <meker@adobe.com>
Date: Mon, 9 Mar 2026 14:38:13 -0500
Subject: [PATCH 4/5] Update index.md

Add new Valkey CLI command and link to related documentation.
---
 .../development/backward-incompatible-changes/index.md      | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md
index 06224e6ae..0a8e60557 100644
--- a/src/pages/development/backward-incompatible-changes/index.md
+++ b/src/pages/development/backward-incompatible-changes/index.md
@@ -122,6 +122,12 @@ A dedicated CLI command was added to configure and enable Valkey 8.x, minimizing
 
 No action is required for existing customers. Use the new CLI command when configuring Valkey instead of Redis.
 
+```terminal
+bin/magento setup:config:set --cache-backend=valkey
+```
+
+For details, see [Use Valkey for default cache](https://experienceleague.adobe.com/en/docs/commerce-operations/configuration-guide/cache/valkey/valkey-pg-cache).
+
 ### Zend_Cache replaced with symfony/cache
 
 The deprecated Zend_Cache implementation was replaced with the `symfony/cache` component. Symfony/cache is actively maintained and improves cache management performance, maintainability, and compatibility with PHP 8.x and future framework updates.\<!--AC-16067--\>

From 88a8d4f22f0069f445aca65b3f5844f3daa8b978 Mon Sep 17 00:00:00 2001
From: Margaret Eker <meker@adobe.com>
Date: Mon, 9 Mar 2026 14:58:12 -0500
Subject: [PATCH 5/5] Apply suggestions from code review

---
 src/pages/development/backward-incompatible-changes/index.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/pages/development/backward-incompatible-changes/index.md b/src/pages/development/backward-incompatible-changes/index.md
index 0a8e60557..815d078df 100644
--- a/src/pages/development/backward-incompatible-changes/index.md
+++ b/src/pages/development/backward-incompatible-changes/index.md
@@ -9,7 +9,7 @@ keywords:
 
 This page highlights backward-incompatible changes between Adobe Commerce and Magento Open Source releases that have a major impact and require detailed explanation and special instructions to ensure third-party modules continue working. High-level reference information for all backward-incompatible changes in each release is documented in the [reference](reference.md) section.
 
-## 2.4.9-beta
+## 2.4.9-beta1
 
 The following major backward-incompatible changes were introduced in the 2.4.9-beta1 Adobe Commerce and Magento Open Source releases: