AEM Cloud Service deprecated APIs and incompatibilities

What AEM 6.5 code must change before it runs on AEM as a Cloud Service. Since 14 April 2026, Cloud Manager fails builds that use removed APIs.

Removed

ItemStatusReplacement
APIs removed Feb 2026Removed 26 February 2026SLF4J for logging, Sling Auth Core for authentication, the OSGi Http Whiteboard for servlets and filters, and your own embedded library versions for Jetty client, Guava or metadata extraction.
Google GuavaRemoved 26 February 2026JDK collections and java.util.Objects for most uses, Caffeine for caches, or an embedded Guava version (Adobe's notes list guava 33.4.8-jre) when the dependency is unavoidable.

Scheduled for removal

ItemStatusReplacement
APIs removed Mar 2027Removal scheduled 31 March 2027org.apache.sling.xss for XSS protection, the Servlet API's multipart support for uploads, com.day.cq.commons.predicates, and embedded current versions of Tika or Handlebars where you need them.
Sling Commons JSONRemoval planned (tentative) 31 December 2027javax.json (Apache Johnzon, provided by the platform), or Jackson / Gson embedded in your bundle.
Commons Lang 2Removal planned (tentative) 31 December 2027org.apache.commons.lang3, which the platform provides.
Commons Collections 3Removal planned (tentative) 31 December 2027org.apache.commons.collections4 or standard JDK collections and streams.
org.json and sling.runmodeRemoval planned (tentative) 31 December 2027javax.json for JSON.

Not supported on Cloud Service

ItemStatusReplacement
Felix SCR annotationsNot supported on Cloud Serviceorg.osgi.service.component.annotations (@Component, @Reference, @Activate) with org.osgi.service.metatype.annotations (@Designate, @ObjectClassDefinition).
Admin resource resolverNot supported on Cloud ServiceResourceResolverFactory.getServiceResourceResolver with a sub-service name, a system user created through repoinit, and a ServiceUserMapperImpl.amended OSGi configuration.
Replication agentsNot supported on Cloud ServiceManage Publication or the Tree Activation workflow step for authors; Replicator API calls for code; event-driven integrations for anything that used a custom agent to push content elsewhere.
Classic UI dialogsNot supported on Cloud ServiceGranite UI (Coral 3) cq:dialog definitions; custom widgets become Granite UI fields or small client libraries.
Content under /etcNot supported on Cloud ServiceContext-aware configuration in /conf, workflow models in /conf/global/settings/workflow/models, and runtime instances in /var.
Mutable vs immutableNot supported on Cloud ServiceThe AEM project archetype layout: ui.apps for immutable code, ui.content for mutable content, ui.config for OSGi configuration, and an all package.
OSGi config formatNot supported on Cloud Service.cfg.json files in ui.config, with secrets and per-environment values supplied by Cloud Manager environment variables ($[secret:NAME] and $[env:NAME]).
Custom run modesNot supported on Cloud Serviceconfig.author, config.publish and combinations with dev, stage, prod and rde; values that differ between environments of the same type come from Cloud Manager environment variables.
Custom Oak indexesNot supported on Cloud ServiceLucene index definitions in ui.apps named with the -custom-<n> suffix, increased on every change.
Local file systemNot supported on Cloud ServiceThe JCR repository for small data, Sling Jobs for queued work, and external object storage for large files.
Custom authenticationNot supported on Cloud ServiceAdobe IMS for authors; the SAML 2.0 authentication handler or a reviewed custom handler for publish; OAuth server-to-server credentials for integrations (JWT credentials are deprecated).
Oak internal APIsNot supported on Cloud Servicejavax.jcr, org.apache.jackrabbit.api and Sling resource APIs.
AEM CommunitiesNot supported on Cloud ServiceA dedicated community platform integrated through APIs, or retiring the feature.
Legacy commerceNot supported on Cloud ServiceAEM CIF Core Components with a GraphQL commerce backend.
uber-jarNot supported on Cloud Servicecom.adobe.aem:aem-sdk-api at the version matching your target release, plus the AEM Analyser Maven plugin in the build.
Dispatcher configNot supported on Cloud ServiceThe Cloud Service dispatcher layout in flexible mode, validated locally with the dispatcher tools in the AEM SDK.

Deprecated

ItemStatusReplacement
JCR EventListenerDeprecated on Cloud Serviceorg.apache.sling.api.resource.observation.ResourceChangeListener for notification, and Sling Jobs (JobManager + JobConsumer) for work that must run exactly once.
Sling SchedulerDeprecated on Cloud ServiceScheduled Sling Jobs created through JobManager.createJob(topic).schedule(), processed by a JobConsumer.
Foundation componentsDeprecated on Cloud ServiceProxy components under /apps that set sling:resourceSuperType to a versioned Core Component, for example core/wcm/components/text/v2/text.
Static templatesDeprecated on Cloud ServiceEditable templates and content policies under /conf, created with the Modernization Tools template and policy converters.
DAM Update AssetDeprecated on Cloud ServiceProcessing profiles for renditions and metadata, post-processing workflows for custom steps, and Dynamic Media for video transcoding.
com.day.cq.workflowDeprecated on Cloud Servicecom.adobe.granite.workflow.exec.WorkflowProcess and related Granite interfaces.
HTL JavaScript Use APIDeprecated on Cloud ServiceSling Models (Java Use API) adapted from the request or resource.