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
Learn about strategies for planning and implementing a successful Adobe Commerce site.
Learn how Adobe Commerce merchants are responsible for maintaining a secure environment.
Use these recommendations to optimize the performance of your Adobe Commerce deployment.
System management
Learn how to upgrade your Adobe Commerce project to keep your storefront secure and operating efficiently.
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.
November 14, 2025
Description
Type
Source
Documented a new developer setting to optimize CSS and javascript files. When enabled, this setting automatically defers non-critical scripts loaded into the header section. For details, see Optimize resource files in the Implementation Playbook.
Technical
November 13, 2025
Description
Type
Source
November 12, 2025
Description
Type
Source
Added a hotfix for the Checkout page fails to load static.min.js and mixins.min.js issue:
- 2.4.8-p3
- 2.4.7-p8
- 2.4.6-p13
- 2.4.5-p15
- 2.4.4-p16.
- 2.4.8-p3
- 2.4.7-p8
- 2.4.6-p13
- 2.4.5-p15
- 2.4.4-p16.
Technical
Updated the
bin/magento setup:config:set CLI command in the Configure Valkey default caching instructions to specify the correct value for the cache-backend parameter.Technical, feedback
November 10, 2025
Description
Type
Source
Updated version numbers for the Catalog Service for Adobe Commerce to 1.42 in the product availability services documentation.
Technical
October 31, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-67424: Updated_at value in the GET /carts/search REST API response does not match the value shown in the Admin Panel when using Negotiable Quotes.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-67383: Login as Customer with two company admin accounts in the same session causes a "No such entity with cartId" error.
New topic, qpt
October 30, 2025
Description
Type
Source
October 29, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-68064: Creating scheduled updates results in duplicate entries in environments with a high number of nested categories.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-67946: Cart updates show duplicate error banners.
New topic, qpt
October 28, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-68040: Frontend search page experiences performance degradation on MariaDB 10.6 and 11.4 with many historical search requests.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-68118: CustomerCart GraphQL query returns product attribute values that do not reflect the store header, causing inconsistent localization.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-66807: Report_viewed_product_index table shows an incorrect count of product page views.
New topic, qpt
October 27, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-67639: Creating a credit memo fails for bundle products with Dynamic Price set to No.
New topic, qpt
October 24, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-67518: Advanced reporting generates duplicated header rows when the row count exceeds the batch size.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-67941: GraphQL requests with unknown filter names cause PHP exception logs.
New topic, qpt
October 23, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-68011: Non-existent SKUs can be assigned to a shared catalog via the /V1/sharedCatalog/:id/assignProducts REST API.
New topic, qpt
Add an important note on the
- Release notes for 2.4.6-p13
- Perform an upgrade
magento/inventory-composer-installer package requirement for 2.3 to 2.4.6-p13 upgrade:- Release notes for 2.4.6-p13
- Perform an upgrade
Technical
October 22, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.72 fix for ACSD-67696: Media_gallery entries do not return in the Cart GraphQL product node after a cache flush.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-67187: Admin users restricted to non-default websites get Please create at least a public shared catalog to proceed error.
New topic, qpt
Added detailed description of the QPT 1.1.72 fix for ACSD-68092: Bundle product options are lost after multiple saves.
New topic, qpt
October 20, 2025
Description
Type
Source
October 17, 2025
Description
Type
Source
October 16, 2025
Description
Type
Source
October 14, 2025
Description
Type
Source
October 2025 release:
- Added release notes for the October 2025 security patches: 2.4.8-p3, 2.4.7-p8, 2.4.6-p13, 2.4.5-p15, 2.4.4-p16.
- Added system requirements for 2.4.9-alpha3, 2.4.8-p3, 2.4.7-p8, 2.4.6-p13, 2.4.5-p15, 2.4.4-p16.
- Added release notes to cover highlights and fixed issues introduced in v2.4.9-alpha3 for Adobe Commerce and Magento Open Source.
- Added a description of the Cloud Automation Patch Service to Adobe Commerce beta releases.
- Updated the release schedule for 2026.
- Added detailed instructions for installing and configuring the ActiveMQ (Artemis) message broker for on-premises deployments.
- Added Configuring alternativeHeaders for Client IP Detection to GraphQL Application Server.
- Added release notes for the October 2025 security patches: 2.4.8-p3, 2.4.7-p8, 2.4.6-p13, 2.4.5-p15, 2.4.4-p16.
- Added system requirements for 2.4.9-alpha3, 2.4.8-p3, 2.4.7-p8, 2.4.6-p13, 2.4.5-p15, 2.4.4-p16.
- Added release notes to cover highlights and fixed issues introduced in v2.4.9-alpha3 for Adobe Commerce and Magento Open Source.
- Added a description of the Cloud Automation Patch Service to Adobe Commerce beta releases.
- Updated the release schedule for 2026.
- Added detailed instructions for installing and configuring the ActiveMQ (Artemis) message broker for on-premises deployments.
- Added Configuring alternativeHeaders for Client IP Detection to GraphQL Application Server.
Major update
October 9, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.71 fix for ACSD-67093: Retrieving orders through GraphQL using the date range filter returns incorrect results..
New topic, qpt
October 8, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.70 fix for ACSD-67030: Simple products are unassigned from a configurable product when edited by a limited role admin.
New topic, qpt
October 7, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.70 fix for ACSD-66120: GraphQL incorrectly displayed discount percentages and base prices when catalog prices were configured to include tax.
New topic, qpt
Added detailed description of the QPT 1.1.71 fix for ACSD-67652: Bundle product status returned as out-of-stock in GraphQL calls with child and parent products in stock.
New topic, qpt
Added detailed description of the QPT 1.1.71 fix for ACSD-60624: Upload Image fails for empty content in Image, Banner, and Slider sections in Page Builder.
New topic, qpt
Added detailed description of the QPT 1.1.71 fix for ACSD-67459: Unable to import products with descriptions longer than 65,536 characters.
New topic, qpt
Added detailed description of the QPT 1.1.71 fix for ACSD-67089: inventory/export-stock-salable-qty API returns incorrect total_count when page_size is set.
New topic, qpt
Added information about the SWAT Health Index Score to the Site Wide Analysis Tool Guide.
New topic
October 6, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.70 fix for ACSD-66157: Special price doesn't take effect for websites created in different time zones.
New topic, qpt
Added detailed description of the QPT 1.1.70 fix for ACSD-67659: Translated error messages return an UNDEFINED error code.
New topic, qpt
October 1, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.70 fix for ACSD-67102: Category loading takes a considerable amount of time or causes a timeout when a large number of categories and products are involved.
New topic, qpt
September 30, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.71 fix for ACSD-67904: orders can't be placed if the city name contains digits (0–9), ampersand (&), period (.), or parentheses ()..
New topic, qpt
Added detailed description of the QPT 1.1.71 fix for ACSD-67643: Duplicate entries created during scheduled updates in high-nested category environments.
New topic, qpt
Added detailed description of the QPT 1.1.71 fix for ACSD-67603: Sitemap generation for products with image inclusion enabled experiences long processing times.
New topic, qpt
September 25, 2025
Description
Type
Source
September 22, 2025
Description
Type
Source
Added detailed description of the QPT 1.1.70 fix for ACSD-67166: Duplicate execution of the cataloginventory_stock_status query when loading a quote on the storefront.
New topic, qpt
Added guidance for enabling stale cache on cloud via config.php; new sections on Redis lazyfree and multithreaded I/O (requestable via Support); clarified session Redis example; and added client timeout/retry guidance with an explicit overload caveat.
Major update
recommendation-more-help
20c66b1f-e128-42a3-aefa-b6cce0437110