Adobe Commerce Operational Guides
Use this following collection of guides to learn about system administration concepts, processes, tools, and best practices to plan, configure, deploy, and maintain Adobe Commerce projects.
Planning and guidance
System management
What’s new
This page contains the changes made in the last 60 days. We exclude all minor updates, such as copy editing, from this list.
May 13, 2026
Description
Type
Source
Corrected Valkey LTS compatibility to 8.1 in the 2.4.5 security patch releases, 2.4.6 security patch releases, and 2.4.8 security patch releases topics so the cache-backend guidance matches supported Valkey on Adobe Commerce on cloud infrastructure.
Addresses the issue #177.
Addresses the issue #177.
Technical, feedback, release notes
Added a System requirements for earlier Commerce releases collapsible section with reference tables and MySQL 8.0 / Elasticsearch 7.17 end-of-support guidance for older Adobe Commerce versions.
Technical
May 12, 2026
Description
Type
Source
Documented May 12, 2026 security patch releases and 2.4.9 GA in Released versions. Also:
- Corrected 2.4.7-p10 platform highlights (MariaDB 11.8, Valkey 8.1 LTS) in Adobe Commerce 2.4.7 security patches.
- Fixed the 2.4.8 security patch topic description metadata in Adobe Commerce 2.4.8 security patches.
- Corrected 2.4.7-p10 platform highlights (MariaDB 11.8, Valkey 8.1 LTS) in Adobe Commerce 2.4.7 security patches.
- Fixed the 2.4.8 security patch topic description metadata in Adobe Commerce 2.4.8 security patches.
Major update, feedback
Updated Packages, bin/magento, and required PHP extensions for v2.4.9.
Updated security patch release notes (2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8) to reference Adobe Security Bulletin APSB26-49 and document new platform compatibility highlights for 2.4.8 patches, 2.4.7 patches, 2.4.6 patches, 2.4.5 patches, and 2.4.4 patches.
Updated Adobe Commerce 2.4.9 release notes and Magento Open Source 2.4.9 release notes with GA fixed issues data and include paths aligned to the 2.4.9 release (replacing beta-era fixed-issues sources).
Updated highlight sections for Adobe Commerce 2.4.9 release notes and Magento Open Source 2.4.9 release notes for GA.
Updated System requirements for 2.4.9, recent security-patch lines, and on-premises and cloud dependency tables.
Updated the UCT CLI reference to version 3.0.27.
Updated cache configuration documentation for Commerce 2.4.9 Symfony Cache support:
- Use Redis for default cache — Added tabbed content for Zend and Symfony Cache implementations with performance optimizations.
- Use Valkey for default cache — Added tabbed content for Zend and Symfony Cache implementations with performance optimizations.
- L2 cache — Added modern Symfony L2 Cache implementation (
- Cache options — Added implementation options comparing Zend-based and Symfony Cache backends.
- Cache types — Added references to modern Symfony Cache backend types.
Updated security patch release notes (2.4.4, 2.4.5, 2.4.6, 2.4.7, 2.4.8) to reference Adobe Security Bulletin APSB26-49 and document new platform compatibility highlights for 2.4.8 patches, 2.4.7 patches, 2.4.6 patches, 2.4.5 patches, and 2.4.4 patches.
Updated Adobe Commerce 2.4.9 release notes and Magento Open Source 2.4.9 release notes with GA fixed issues data and include paths aligned to the 2.4.9 release (replacing beta-era fixed-issues sources).
Updated highlight sections for Adobe Commerce 2.4.9 release notes and Magento Open Source 2.4.9 release notes for GA.
Updated System requirements for 2.4.9, recent security-patch lines, and on-premises and cloud dependency tables.
Updated the UCT CLI reference to version 3.0.27.
Updated cache configuration documentation for Commerce 2.4.9 Symfony Cache support:
- Use Redis for default cache — Added tabbed content for Zend and Symfony Cache implementations with performance optimizations.
- Use Valkey for default cache — Added tabbed content for Zend and Symfony Cache implementations with performance optimizations.
- L2 cache — Added modern Symfony L2 Cache implementation (
symfony_l2 backend) with stale cache support.- Cache options — Added implementation options comparing Zend-based and Symfony Cache backends.
- Cache types — Added references to modern Symfony Cache backend types.
Major update
May 11, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4628: Importing customers with uppercase email addresses triggers an undefined array key error when Account Sharing is set to Global.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4763: The GraphQL customerOrders query returns inflated original_price_including_tax and original_row_total_including_tax.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACSD-60989: Modifying a column with a foreign key through declarative schema causes errors on MariaDB.
New topic, qpt
Updated Shared responsibility security and operational model to clarify that merchants must keep platform services, third-party dependencies, and Commerce Services extensions on actively supported versions to remain eligible for Adobe security support, with new guidance for PHP, MariaDB, Redis, and OpenSearch.
Technical
May 7, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4732: Partial indexation stops for customers with many updates when the version_id column in the changelog table reaches its maximum value.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4591: Customer segments based on order count, such as "First-time buyers", do not update when orders are placed through the REST API.
New topic, qpt
May 6, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4456: Canceling an order with a GraphQL mutation does not move orders paid entirely with gift cards to the Closed status.
New topic, qpt
May 4, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4448: Configuration changes made during Redis outages do not reflect after Redis recovers, and stale values persist.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4452: Product prices on the Quick Order page include tax regardless of the tax display configuration.
New topic, qpt
May 1, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4665: Child products of configurable products with videos in the product galleries do not appear when requested through the REST API.
New topic, qpt
April 30, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4613: Large media directory structures slow gettree responses and delay Media Gallery directory tree loading.
New topic, qpt
April 29, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4535: Submitting the forgot-password form destroys or regenerates the session (PHPSESSID changes) and clears the guest cart.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4507: Password Options configuration does not apply to customer password reset requests made through GraphQL mutations.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4609: The My Quotes page shows no quotes when some quotes contain deleted products.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4431: Related Products matched by target rules are deleted during the reindex process.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4416: Customer reward points do not initialize when created in the Admin.
New topic, qpt
April 28, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4540: The Fotorama library does not load correctly, so only the first attached image is visible.
New topic, qpt
April 27, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4522: Intermittent duplicate key errors occur on the quote_coupons table when multiple cart merge or quote save requests run at the same time.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4565: The Company GraphQL query returns "The current customer isn't authorized" when the X-Adobe-Company header is used.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4419: Gift cards do not apply correctly at checkout after successful reCAPTCHA v2 validation on the storefront.
New topic, qpt
Added detailed description of the QPT 1.1.78 fix for ACP2E-4555: Telephone numbers that contain periods or forward slashes do not validate properly.
New topic, qpt
April 23, 2026
Description
Type
Source
April 20, 2026
Description
Type
Source
- Updated Lifecycle policy with revised end-of-support table, extended support scope, and a new section on additional security fixes provisioning for 2.4.4 and 2.4.5.
- Updated Versioning policy and Release schedule for isolated security fixes prerequisites and hotfix/individual patch delivery through the Quality Patches Tool; moved isolated security fixes detail into the shared security patch overview include.
- Refreshed the 2026 release calendar to match current schedule.
Technical, major update
April 8, 2026
Description
Type
Source
Updated System requirements with New Relic (APM) supported versions for Commerce on Cloud by release.
Technical, feedback
Updated Beta releases with a Category Merchandising (Public Beta) program for SaaS projects, including links to Category merchandising and related merchandising rules topics.
Major update
April 3, 2026
Description
Type
Source
Added instructions for properly overriding Adobe Commerce’s default L2 cache directories in
env.php to ensure that cache files are stored in the intended location and prevent split cache directories and GlusterFS segmentation faults. See the updated guidance in Best practices for Redis and Valkey services configuration.Technical, feedback
April 1, 2026
Description
Type
Source
Updated the 2026 Adobe Commerce release calendar with the most current release information.
Release notes
Updated the best practices for Redis and Valkey configuration and provided related configuration guidance.
Technical, feedback
March 19, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.76 fix for ACSD-69319: Bundle prices were not indexed properly when child products had stock under custom sources.
New topic, qpt
March 18, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.76 fix for ACSD-69086: Installation fails on MariaDB 10.11 due to unsupported database version check.
New topic, qpt
March 17, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.76 fix for ACSD-69331: Content creators in the media gallery could not create folders with only the
create_folder permission. After the fix, they can create folders as expected.New topic, qpt
recommendation-more-help
commerce-operations-help-home