Documentation

Upgrade jQuery version in AEM as a Cloud Service

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Adobe Experience Manager (AEM) as a Cloud Service – Sites uses a default jQuery version (v1.12.4-aem), which is maintained by Adobe and receives security updates. If you need to upgrade to a newer version of jQuery for compliance or feature requirements, you must override the default client library with your preferred version.

Description description

Environment

Adobe Experience Manager (AEM) as a Cloud Service – Sites

Issue/Symptoms

The application uses Adobe’s default jQuery v1.12.4-aem but requires an upgrade to the latest version for compliance or other needs.

Resolution resolution

To replace the default jQuery library with a custom one, follow these steps:

  1. Add your preferred jQuery version as a client library under /apps/<project>/clientlibs/clientlib-jquery.
  2. Set the categories property to jquery and the replaces property to/libs/clientlibs/granite/jquery.
  3. Test the updated library in the development and staging environments.
  4. Test interactive components (for example, modals, sliders, and AJAX calls) across environments to ensure compatibility with the new jQuery version.
  5. Verify that the application works correctly with the new jQuery version.
  6. Deploy the changes to production after successful testing.
  7. Monitor the codebase for dependencies that could be affected by future jQuery updates.

After following all the above steps, ensure that only your preferred version of jQuery is in use and that all functionality works as expected across environments.

Additional Notes:

  • Managing your own version of jQuery gives you control over updates but also makes you responsible for ensuring compatibility during future upgrades.
  • The default Adobe-provided jQuery version 1.12.4-aem receives all relevant security updates and may already address specific vulnerabilities without requiring an upgrade.
  • Test thoroughly before deploying changes to production to avoid potential conflicts or functionality issues.
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f