Magento 2: How to Apply Quality Patches Safely and Efficiently

Step 1: Install Quality Patches Tool (if not installed)

Run this from your Magento root directory:

composer require magento/quality-patches

This installs the QPT tool which lets you apply official Adobe patches.

Step 2: List Available Patches

Use the following command to list all available patches for your version:

bin/magento patch:quality:list

You’ll get output like:

AVAILABLE PATCHES

+------------------+--------------------------+

| Patch Name | Description |

+------------------+--------------------------+

| ACSD-12345 | Fix for checkout bug |

| ACSD-98765 | Fix for category filter |

+------------------+--------------------------+

Step 3: Apply a Quality Patch

To apply a patch (e.g., ACSD-12345):

bin/magento patch:quality:install ACSD-12345

This modifies the necessary files in your vendor/ directory and tracks it in composer.json.

Step 4: Run Magento Upgrade Commands

After applying the patch, run the following:

bin/magento setup:upgrade

bin/magento setup:di:compile

bin/magento setup:static-content:deploy

bin/magento cache:flush

Step 5: Test the Patch

Make sure the patch doesn't break existing functionality. Test:

• Admin panel functionality

• Checkout

• Product/category pages

• The area the patch addresses (check patch description)
  

❌ Optional: Revert a Patch

To remove a previously applied patch:

bin/magento patch:quality:revert ACSD-12345

Then:

bin/magento setup:upgrade

bin/magento setup:di:compile

bin/magento setup:static-content:deploy

bin/magento cache:flush