DocumentationExperience Cloud KCS

Classic Compatibility Package unsupported and /libs/commerce components unavailable after upgrade in AEM 6.5 LTS SP3

Last update: October 12, 2026

In Adobe Experience Manager 6.5 LTS SP3, the /libs/commerce component library is missing after upgrading from AEM 6.5 SP24, and implementations that rely on classic CIF components stop working. This affects component dialogs and page templates that reference /libs/commerce resource types. To fix this issue, replace dependencies on classic CIF components with a supported Commerce integration approach in Adobe Experience Manager 6.5 LTS SP3.

Description description

Environment

Adobe Experience Manager (AEM) 6.5 LTS SP3

Symptoms

  • After upgrading from AEM 6.5 SP24 to 6.5 LTS SP3, the /libs/commerce component library is missing.
  • Implementations that rely on classic CIF (Commerce Integration Framework) components, such as component dialogs and page templates that reference /libs/commerce resource types, fail to function.

Cause

The CIF Classic Compatibility Package isn’t supported in AEM 6.5 LTS SP3, and the classic CIF components have been removed in this release.

Resolution resolution

  1. Don’t install the CIF Classic Compatibility Package on AEM 6.5 LTS SP3, as it isn’t supported and causes issues.

  2. If your implementation depends on classic CIF components, remain on AEM 6.5 SP24 with the compatibility package in place as a temporary solution.

  3. Begin a migration project to refactor your implementation from classic CIF components to the modern CIF Add-On and CIF Core Components (GraphQL-based):

    1. Identify all usages of classic CIF components (such as /libs/commerce, /var/commerce, and com.adobe.cq.commerce.*) in your dialogs, templates, and bundles.
    2. Use tools such as Pattern Detector or LTS Analyzer to locate these dependencies.
    3. Update your codebase to use the supported modern CIF Add-On and CIF Core Components.

  4. Proceed with the upgrade to AEM 6.5 LTS SP3 only after you’ve removed all classic CIF dependencies from your implementation.

  5. After migration and upgrade, verify that your commerce-related components and pages function as expected in the new environment.

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