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.
June 5, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.79 fix for ACP2E-4402: Target Rule incremental indexer doesn't pick disabled products.
New topic, qpt
June 2, 2026
Description
Type
Source
Updated Released versions with additional security fixes provisioning end dates for the 2.4.4 and 2.4.5 release lines (May 2027).
Major update
June 1, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4513: Expired CAPTCHA images are not removed from the system.
New topic, qpt
Added detailed description of the QPT 1.1.79 fix for ACP2E-4531: CMS hierarchy doesn't update hierarchical URL when child page URL key is changed.
New topic, qpt
Added detailed description of the QPT 1.1.79 fix for ACP2E-4505: Circular category dependency from saving a category with stale data in a duplicate browser tab.
New topic, qpt
Updated the supported Nginx version for on-premises Adobe Commerce from 1.28 to 1.30 in the System Requirements for 2.4.8 to 2.4.4 latest patch versions. Adobe Commerce on Cloud Infrastructure continues to use Nginx 1.28.
Technical
Updated MariaDB and Nginx versions in system requirements for On-Prem tab for v2.4.9.
Technical
May 29, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.79 fix for ACP2E-4720: Free shipping cart price rules don't reset for fixed-price bundle products with Ship Items Separately.
New topic, qpt
May 28, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.78 fix for ACP2E-4528: Customer address city validation mishandles forward slashes (/) and invalid characters such as !, ", #, and ?.
New topic, qpt
May 27, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.79 fix for ACP2E-4411: Bundle product prices show incorrect tax and currency values between the Product Detail Page and cart in a multi-currency setup.
New topic, qpt
Added detailed description of the QPT 1.1.79 fix for ACP2E-4110: Bundle product prices with a special price differ between PDP/PLP and cart in a non-default currency.
New topic, qpt
Added detailed description of the QPT 1.1.79 fix for ACP2E-4475: Order or filter by price not working for out-of-stock bundle products.
New topic, qpt
Added detailed description of the QPT 1.1.79 fix for ACP2E-4603: Catalog Permissions product reindex leave stale permission index rows and MySQL deadlock.
New topic, qpt
Added detailed description of the QPT 1.1.79 fix for AC-10698: Transaction prices and totals aren't sent to Google Tag.
New topic, qpt
May 23, 2026
Description
Type
Source
Added typo and URL fixes of the QPT 1.1.30 fix for B2B-2598: Adds caching capability to storeConfig, currency, country, countries, availableStores GraphQl queries.
Qpt
May 22, 2026
Description
Type
Source
Updated Adobe Commerce 2.4.9 release notes and Magento Open Source 2.4.9 release notes: clarified the AC-10933
Credit: hostep
setup:di:compile fix, removed cancelled fix AC-14519, and adjusted fixed-issue counts.Credit: hostep
Feedback, technical
Added detailed description of the QPT 1.1.79 fix for AC-10737: Bin/magento
setup:db:status command doesn't recognize JSON data type.New topic, qpt
May 20, 2026
Description
Type
Source
Added detailed description of the QPT 1.1.79 fix for ACP2E-4601: Re-saving a payment authorization transaction self-reference parent_id and trigger an infinite loop/OOM.
New topic, qpt
Updated Software lifecycle policy with Cloud version upgrade enforcement dates, support period definitions (including security-only transitional period), an expanded end-of-support table for 2.4.4–2.4.9, PHP PCI guidance, and paths to migrate to Adobe Commerce as a Cloud Service or upgrade on PaaS.
Major update
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, feedback
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
recommendation-more-help
commerce-operations-help-home