DocumentationExperience Cloud KCS

Patch not found errors during Adobe Commerce deployment

Last update: August 13, 2026

Adobe Commerce deployment or manual patch application fails with a patch not found errorafter an upgrade. The environment references patches that aren’t available for the target Adobe Commerce version, or it uses an outdated Quality Patches Tool package that doesn’t recognize supported patch versions. Review the configured patch IDs, verify patch compatibility for the target version, and remove unsupported patch references before redeploying.

Description description

Environment

  • Adobe Commerce on cloud infrastructure
  • Upgrade deployments that use .magento.env.yaml
  • Quality Patches Tool (QPT)
  • Manual patch application using vendor/bin/magento-patches apply

Issue/Symptoms

  • Deployment or manual patch application fails after an Adobe Commerce upgrade.

  • Deployment logs display errors such as:

    • Next patches weren’t found: MDVA-XXXXX, ACSD-XXXXX
    • Next patches weren’t found: ACSD-12345

  • The logs recommend checking patch availability by using the status command.

Cause

This issue occurs when:

  • Patch IDs configured in .magento.env.yaml are not available for the target Adobe Commerce version.
  • Previously applied patches are no longer applicable after upgrading.
  • The installed Quality Patches Tool (QPT) package is outdated and does not recognize newer patch variants.

Resolution resolution

Follow these steps to resolve the issue

  1. Review the QUALITY_PATCHES section in .magento.env.yaml.

  2. Identify all configured patch IDs.

  3. Verify each patch ID in the Quality Patches Release Notes for compatibility with the target Adobe Commerce version.

  4. Update the Quality Patches Tool (QPT) package if it does not support the required patch versions.

  5. Remove unsupported or obsolete patch IDs from the configuration.

  6. Save the changes, push the updated code, and redeploy the environment.

  7. If applying patches manually, verify patch compatibility before running:

    code language-none 
    vendor/bin/magento-patches apply

Apply patches in Commerce on Cloud Infrastructure Guide.

recommendation-more-help
experience-cloud-kcs-help-kbarticles