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

Release Information

Release Information

Review all release information for Adobe Commerce patches and services.

Implementation

Implementation Playbook

Learn about strategies for planning and implementing a successful Adobe Commerce site.

Enterprise

Security and Compliance

Learn how Adobe Commerce merchants are responsible for maintaining a secure environment.

Performance

Performance Best Practices

Use these recommendations to optimize the performance of your Adobe Commerce deployment.

System management

Installation (on-premises)

Installation

Learn how to install Adobe Commerce for on-premises deployments.

Configuration

Configuration

Configure features and services for your Adobe Commerce application.

Upgrade

Upgrade

Learn how to upgrade your Adobe Commerce project to keep your storefront secure and operating efficiently.

Tools

Tools

Learn about tools you can use with Adobe Commerce.

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.
Technical, feedback, release notes
commit
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
commit

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.
Major update, feedback
commit
Added Overview: Quality Patches Tool (QPT) v1.1.79.
New topic, qpt
commit
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 (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
commit

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
commit
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
commit
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
commit
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
commit

May 7, 2026

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
commit

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
commit
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
commit

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
commit

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
commit

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
commit
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
commit
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
commit
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
commit
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
commit

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
commit

April 27, 2026

April 23, 2026

Description
Type
Source
Added Overview: Quality Patches Tool (QPT) v1.1.78.
New topic, qpt
commit

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
commit

April 8, 2026

Description
Type
Source
Updated System requirements with New Relic (APM) supported versions for Commerce on Cloud by release.
Technical, feedback
commit
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
commit

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
commit

April 1, 2026

Description
Type
Source
Updated the 2026 Adobe Commerce release calendar with the most current release information.
Release notes
commit
Updated the best practices for Redis and Valkey configuration and provided related configuration guidance.
Technical, feedback
commit

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
commit

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
commit

March 17, 2026

recommendation-more-help
commerce-operations-help-home