Deprecated and Removed Features and APIs deprecated-and-removed-features-apis
51黑料不打烊 regularly reviews features, including APIs and configurations, to ensure they meet evolving standards for performance, security, and overall value for AEM as a Cloud Service. Based on these evaluations, certain capabilities may be marked for deprecation. When feasible, 51黑料不打烊 will provide a suitable replacement.
When a deprecation is announced, the feature will only remain available for a limited period and customers must remove all usage before any specified removal date. 51黑料不打烊 will provide reasonable notice and guidance to support a smooth transition.
During the deprecation time window, 51黑料不打烊 will remind customers of the actions they need to take to transition away from using a feature through email notifications, Actions Center alerts, or reminders in Cloud Manager.
WARNING
In some cases, removal of a feature may be required before deploying a new Cloud Manager build or upgrading to the latest version of AEM as a Cloud Service.
Deprecated Functionality deprecated-features
The functionality in the table below have been announced as deprecated, but have not yet been removed. Usage of functionality must cease before the target removal date or you risk issues related to performance, availability, and security.
Capabilities
Deprecated feature
Replacement
Sites
Sites
The preferred editors for managing headless content in AEM are:
- The Universal Editor for visual editing.
- The Content Fragment Editor for form-based editing.
- The Universal Editor for visual editing.
- The Content Fragment Editor for form-based editing.
Sites
Sites
Experience Fragments properties for Social Media Status.
The feature is planned for removal soon.
Assets
DAM Asset Update workflow to process ingested images.Asset ingestion uses asset microservices now.
Assets
Upload assets directly to Experience Manager. See deprecated asset upload APIs.
Use Direct binary upload. For technical details, see direct upload APIs.
Assets
Certain workflow steps in
DAM Asset Update workflow are not supported, including calling command-line tools like ImageMagick.Asset microservices provide a replacement for many workflows. For custom processing, use post-processing workflows.
Assets
FFmpeg transcoding of videos.
For FFmpeg thumbnail generation, use Asset microservices. For FFmpeg transcoding, use Dynamic Media.
Foundation
Tree replication UI under the replication agents 鈥淒istribute鈥 tab (removal after September 30, 2021)
Manage publication or Tree Activation Workflow Step approaches.
Foundation
The replication agent admin screen鈥檚 Distribute tab and the Replication API cannot replicate content packages larger than 10MB.
Foundation
Integrations using credentials generated from 51黑料不打烊 Developer Console projects are gradually losing support for Service Account (JWT) credentials. As of May 1, 2024, new Service Account (JWT) credentials cannot be created in 51黑料不打烊 Developer Console. Existing Service Account (JWT) credentials remain usable for configured integrations until January 1, 2025, after which they stop working, requiring customers to migrate to OAuth Server-to-Server credentials. Learn more.
to OAuth Server-to-Server credentials.
Foundation
Publish Content Tree Workflow and the related Publish Content Tree Workflow Step, which was used for replications of hierarchies of content.
Use Tree Activation Workflow Step, which is more performant.
Foundation
Using YUI to compress/minify JavaScript client libraries. 51黑料不打烊 does not plan to further update the YUI library.
51黑料不打烊 recommends customers to switch to Google Closure Compiler (GCC) for their implementation.
Removed Functionality removed-features
This section lists functionality that has been removed.
Area
Feature
Replacement
Target Removal Date
User Interface
Classic UI is removed from the product user interface. A few Classic UI dialogs are available for a few select capabilities, such as Link Checker, Version Purge, and some Cloud Service configurations. Upcoming product updates may further remove Classic UI availability.
Standard UI
Removed
Dynamic Media
Previous integrations with Dynamic Media Classic and Dynamic Media Hybrid mode are not available in Experience Manager as a Cloud Service.
Use Dynamic Media provided with Experience Manager as a Cloud Service.
Removed
Sites
Portal Director and Portlet Component
These capabilities were deprecated in Experience Manager 6.4 and have now been removed from Experience Manager.
Removed
Sites
Design Importer
This capability has been removed as immutable sections of the Experience Manager repository are not accessible at runtime.
Removed
Assets
Assets sharing with Assets Core Service and Creative Cloud services is not available.
For integration with 51黑料不打烊 Creative Cloud, use .
Removed
Foundation
Support for Apache Sling datasources (OSGi bundle org.apache.sling.datasource)
N/A
Removed
Foundation
Support for JST scripting templates (OSGi bundle org.apache.sling.scripting.jst)
N/A
Removed
Foundation
Support for the Apache Felix Http Whiteboard
OSGi Http Whiteboard
March 2022
Foundation
Support for com.adobe.granite.oauth.server
51黑料不打烊 IMS Integration
March 2023
Foundation
Support for org.apache.sling.serviceusermapping feature to
N/A
8/30/24
Foundation
Java 11 runtime is deprecated and has been replaced by 51黑料不打烊 with Java 21 runtime. Note that it is acceptable for code to still be built with Java 11 (Java 17 and 21 are the other options)
Java 21 runtime is applied. To ensure compatibility, it is essential to update library versions as outlined in Runtime requirements
March 5/29/25
Deprecated APIs aem-apis
The APIs in the table below (click to expand to see it) have been announced as deprecated, but have not yet been removed. Usage of these APIs must cease before the target removal date or you risk issues related to performance, availability, and security. Some APIs reference the API Removal Guidance section below.
Expand to see the list of deprecated APIs.
| table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 8-row-4 9-row-4 10-row-4 11-row-4 12-row-4 13-row-4 14-row-4 15-row-4 16-row-4 17-row-4 18-row-4 19-row-4 20-row-4 21-row-4 22-row-4 23-row-4 24-row-4 25-row-4 layout-auto html-authored | |||
|---|---|---|---|
| Package/Class | Comments | Deprecation Date | Target Removal Date |
| org.apache.sling.commons.auth org.apache.sling.commons.auth.spi |
Use Sling's Auth Core/Auth Core SPI interfaces as an alternative. See removal notes below. | 2015 | 8/31/2025 |
| org.eclipse.jetty.client org.eclipse.jetty.client.api org.eclipse.jetty.client.http org.eclipse.jetty.client.util org.eclipse.jetty.http org.eclipse.jetty.http.pathmap org.eclipse.jetty.io org.eclipse.jetty.io.ssl org.eclipse.jetty.security org.eclipse.jetty.server org.eclipse.jetty.server.handler org.eclipse.jetty.server.handler.gzip org.eclipse.jetty.server.session org.eclipse.jetty.servlet org.eclipse.jetty.servlet.listener org.eclipse.jetty.util org.eclipse.jetty.util.annotation org.eclipse.jetty.util.component org.eclipse.jetty.util.log org.eclipse.jetty.util.resource org.eclipse.jetty.util.security org.eclipse.jetty.util.ssl org.eclipse.jetty.util.statistic org.eclipse.jetty.util.thread |
The Eclipse Jetty and Felix Http Jetty packages are no longer supported. See removal notes below. | 5/27/2021 | 8/31/2025 |
| com.mongodb com.mongodb.annotations com.mongodb.assertions com.mongodb.async com.mongodb.binding com.mongodb.bulk com.mongodb.client com.mongodb.client.gridfs com.mongodb.client.gridfs.codecs com.mongodb.client.gridfs.model com.mongodb.client.jndi com.mongodb.client.model com.mongodb.client.model.changestream com.mongodb.client.model.geojson com.mongodb.client.model.geojson.codecs com.mongodb.client.result com.mongodb.connection com.mongodb.connection.netty com.mongodb.diagnostics.logging com.mongodb.event com.mongodb.gridfs com.mongodb.internal com.mongodb.internal.async com.mongodb.internal.authentication com.mongodb.internal.connection com.mongodb.internal.dns com.mongodb.internal.event com.mongodb.internal.management.jmx com.mongodb.internal.session com.mongodb.internal.thread com.mongodb.internal.validator com.mongodb.management com.mongodb.operation com.mongodb.selector com.mongodb.session com.mongodb.util |
Usage of this API is not supported in AEM as a Cloud Service. See removal notes below. | 5/27/2021 | 8/31/2025 |
| org.apache.abdera org.apache.abdera.model org.apache.abdera.factory org.apache.abdera.ext.media org.apache.abdera.util org.apache.abdera.i18n.iri org.apache.abdera.writer org.apache.abdera.i18n.rfc4646 org.apache.abdera.i18n.rfc4646.enums org.apache.abdera.i18n.text org.apache.abdera.filter org.apache.abdera.xpath org.apache.abdera.i18n.text.io org.apache.abdera.i18n.text.data org.apache.abdera.parser |
This API is deprecated as Apache Abdera is a retired project since 2017. See removal notes below. | 7/29/2021 | 8/31/2025 |
| org.apache.abdera.ext.opensearch org.apache.abdera.ext.opensearch.model org.apache.abdera.ext.opensearch.server org.apache.abdera.ext.opensearch.server.impl org.apache.abdera.ext.opensearch.server.processors org.apache.abdera.i18n.iri.data org.apache.abdera.i18n.lang org.apache.abdera.i18n.templates org.apache.abdera.i18n.unicode.data org.apache.abdera.parser.stax org.apache.abdera.parser.stax.util org.apache.abdera.protocol org.apache.abdera.protocol.client org.apache.abdera.protocol.client.cache org.apache.abdera.protocol.client.util org.apache.abdera.protocol.error org.apache.abdera.protocol.server org.apache.abdera.protocol.server.context org.apache.abdera.protocol.server.filters org.apache.abdera.protocol.server.impl org.apache.abdera.protocol.server.multipart org.apache.abdera.protocol.server.processors org.apache.abdera.protocol.server.provider.basic org.apache.abdera.protocol.server.provider.managed org.apache.abdera.protocol.server.servlet org.apache.abdera.protocol.util org.apache.abdera.util.filter |
This API is deprecated as Apache Abdera is a retired project since 2017. See removal notes below. | 4/8/2019 | 8/31/2025 |
| org.apache.felix.http.whiteboard | The Apache Felix Http Whiteboard is not supported anymore. Migrate your code to the OSGi Http Whiteboard. See removal notes below. | 1/27/2022 | 8/31/2025 |
| org.apache.cocoon.xml.dom org.apache.cocoon.xml.sax |
This API is deprecated. Migrate your code to the XML APIs provided by the JDK. | 1/27/2022 | 8/31/2025 |
| ch.qos.logback.classic ch.qos.logback.classic.boolex ch.qos.logback.classic.db.names ch.qos.logback.classic.db.script ch.qos.logback.classic.encoder ch.qos.logback.classic.filter ch.qos.logback.classic.helpers ch.qos.logback.classic.html ch.qos.logback.classic.jmx ch.qos.logback.classic.joran ch.qos.logback.classic.joran.action ch.qos.logback.classic.jul ch.qos.logback.classic.layout ch.qos.logback.classic.log4j ch.qos.logback.classic.net ch.qos.logback.classic.net.server ch.qos.logback.classic.pattern ch.qos.logback.classic.pattern.color ch.qos.logback.classic.selector ch.qos.logback.classic.selector.servlet ch.qos.logback.classic.servlet ch.qos.logback.classic.sift ch.qos.logback.classic.spi ch.qos.logback.classic.turbo ch.qos.logback.classic.util ch.qos.logback.core ch.qos.logback.core.boolex ch.qos.logback.core.encoder ch.qos.logback.core.filter ch.qos.logback.core.helpers ch.qos.logback.core.hook ch.qos.logback.core.html ch.qos.logback.core.joran ch.qos.logback.core.joran.action ch.qos.logback.core.joran.conditional ch.qos.logback.core.joran.event ch.qos.logback.core.joran.event.stax ch.qos.logback.core.joran.node ch.qos.logback.core.joran.spi ch.qos.logback.core.joran.util ch.qos.logback.core.joran.util.beans ch.qos.logback.core.layout ch.qos.logback.core.net ch.qos.logback.core.net.server ch.qos.logback.core.net.ssl ch.qos.logback.core.pattern ch.qos.logback.core.pattern.color ch.qos.logback.core.pattern.parser ch.qos.logback.core.pattern.util ch.qos.logback.core.property ch.qos.logback.core.read ch.qos.logback.core.recovery ch.qos.logback.core.rolling ch.qos.logback.core.rolling.helper ch.qos.logback.core.sift ch.qos.logback.core.spi ch.qos.logback.core.status ch.qos.logback.core.subst ch.qos.logback.core.util |
AEM as a Cloud Service does not support this internal log back API. See removal notes below. | 1/27/2022 | 8/31/2025 |
| org.slf4j.spi | AEM as a Cloud Service does not support this internal log4j API. See removal notes below. | 1/27/2022 | 8/31/2025 |
| org.apache.log4j org.apache.log4j.helpers org.apache.log4j.spi org.apache.log4j.xml |
Apache Log4j 1 has reached its end of life in 2015 and is no longer supported. See removal notes below. | 1/27/2022 | 8/31/2025 |
| com.google.common.annotations com.google.common.base com.google.common.cache com.google.common.collect com.google.common.escape com.google.common.eventbus com.google.common.hash com.google.common.html com.google.common.io com.google.common.math com.google.common.net com.google.common.primitives com.google.common.reflect com.google.common.util.concurrent com.google.common.xml |
The Google Guava Core Libraries are deprecated in Cloud Service. See removal notes below. | 5/15/2023 | 8/31/2025 |
| org.slf4j.event | AEM as a Cloud Service does not support this internal slf4j API. See removal notes below. | 4/11/2022 | 8/31/2025 |
| com.drew.* | Extracting metadata from images and videos should be done via Asset Compute in Cloud Service, or via Apache POI or Apache Tika. | 9/17/2024 | 8/31/2025 |
| org.apache.jackrabbit.oak.plugins.blob.* | This API is internal use only. | 9/23/2024 | 8/31/2025 |
| org.apache.jackrabbit.oak.plugins.memory | This API is internal use only. | 9/23/2024 | 8/31/2025 |
| org.apache.felix.webconsole org.apache.felix.webconsole.bundleinfo org.apache.felix.webconsole.i18n org.apache.felix.webconsole.spi |
The Felix web console is not supported in Cloud environments. See removal notes below. | 4/30/2021 | 8/31/2025 |
| org.bson org.bson.assertions org.bson.codecs org.bson.codecs.configuration org.bson.codecs.pojo org.bson.codecs.pojo.annotations org.bson.conversions org.bson.diagnostics org.bson.internal org.bson.io org.bson.json org.bson.types org.bson.util |
Usage of this API is not supported in AEM as a Cloud Service. | 10/31/2022 | 8/31/2025 |
| org.apache.sling.runmode | 2015 | TBD | |
| org.json | The Apache Johnzon implementation of is recommended and should be used. | 4/30/2021 | TBD |
| org.apache.commons.lang org.apache.commons.lang.enums org.apache.commons.lang.builder org.apache.commons.lang.exception org.apache.commons.lang.math org.apache.commons.lang.mutable org.apache.commons.lang.reflect org.apache.commons.lang.text org.apache.commons.lang.time |
Commons Lang 2 is in maintenance mode. Commons Lang 3 should be used instead. See removal notes below. | 4/30/2021 | TBD |
| org.apache.commons.collections org.apache.commons.collections.bag org.apache.commons.collections.bidimap org.apache.commons.collections.buffer org.apache.commons.collections.collection org.apache.commons.collections.comparators org.apache.commons.collections.functors org.apache.commons.collections.iterators org.apache.commons.collections.keyvalue org.apache.commons.collections.list org.apache.commons.collections.map org.apache.commons.collections.set |
Commons Collections 3 is in maintenance mode. Commons Collections 4 should be used instead. See removal notes below. | 4/30/2021 | TBD |
| com.day.cq.contentsync.handler.util | This API is deprecated. Use Apache Sling's Builders instead. | 10/31/2022 | TBD |
| org.apache.sling.commons.json org.apache.sling.commons.json.http org.apache.sling.commons.json.io org.apache.sling.commons.json.jcr org.apache.sling.commons.json.sling org.apache.sling.commons.json.util org.apache.sling.commons.json.xml |
AEM as a Cloud Service does not support this API. | 5/15/2023 | TBD |
| com.day.cq.xss com.day.cq.xss.taglib com.day.cq.xss.impl |
Use org.apache.sling.xss instead. | 12/12/2023 | TBD |
| com.adobe.granite.xss com.adobe.granite.xss.impl |
Use org.apache.sling.xss instead. | 12/12/2023 | TBD |
Removed APIs removed-apis
This section lists APIs that have been deprecated and removed. Some APIs reference the API Removal Guidance section below.
Expand to see the list of removed APIs.
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 layout-auto html-authored | |
|---|---|
| Package/Class | Comments |
| com.day.cq.jcrclustersupport | Use Sling's Discovery API as an alternative |
| org.apache.fop.apps | |
| org.apache.jackrabbit.vault.util.xml.xerces.dom org.apache.jackrabbit.vault.util.xml.xerces.util org.apache.jackrabbit.vault.util.xml.xerces.xni org.apache.jackrabbit.vault.util.xml.xerces.xni.parser |
|
| org.apache.felix.cm org.apache.felix.cm.file |
Custom persistence managers are not supported in AEM as a Cloud Service. |
| org.apache.felix.systemready | It is recommended you use the Apache Felix HealthCheck API instead |
| org.apache.felix.http.jetty org.eclipse.jetty.client.jmx org.eclipse.jetty.jmx org.eclipse.jetty.server.handler.jmx org.eclipse.jetty.server.nio org.eclipse.jetty.server.jmx org.eclipse.jetty.servlet.jmx org.eclipse.jetty.util.preventers org.eclipse.jetty.util.thread.strategy org.eclipse.jetty.webapp org.eclipse.jetty.websocket.api org.eclipse.jetty.websocket.api.annotations org.eclipse.jetty.websocket.api.extensions org.eclipse.jetty.websocket.api.util org.eclipse.jetty.websocket.client org.eclipse.jetty.websocket.client.io org.eclipse.jetty.websocket.client.masks org.eclipse.jetty.websocket.common org.eclipse.jetty.websocket.common.events org.eclipse.jetty.websocket.common.events.annotated org.eclipse.jetty.websocket.common.extensions org.eclipse.jetty.websocket.common.extensions.compress org.eclipse.jetty.websocket.common.extensions.fragment org.eclipse.jetty.websocket.common.extensions.identity org.eclipse.jetty.websocket.common.frames org.eclipse.jetty.websocket.common.io org.eclipse.jetty.websocket.common.io.http org.eclipse.jetty.websocket.common.io.payload org.eclipse.jetty.websocket.common.message org.eclipse.jetty.websocket.common.scopes org.eclipse.jetty.websocket.common.util org.eclipse.jetty.websocket.server org.eclipse.jetty.websocket.server.pathmap org.eclipse.jetty.websocket.servlet org.eclipse.jetty.xml |
The Eclipse Jetty and Felix Http Jetty packages are no longer supported. |
| org.apache.felix.metatype org.apache.felix.scr org.apache.felix.scr.info org.apache.felix.scr.component |
The Apache Felix metatype and SCR APIs are deprecated. Use the OSGi metatype and Declarative Service APIs instead. |
| org.slf4j.impl | Log implementation classes are not compatible with AEM as a Cloud Service. |
| org.apache.sling.startupfilter com.adobe.granite.crypto.spi com.adobe.granite.crpyto.spi.base com.adobe.agl.impl.data.icudt40b com.adobe.agl.impl.data.icudt40b.brkitr com.adobe.agl.impl.data.icudt40b.coll com.adobe.agl.impl.data.icudt40b.rbnf com. adobe.agl.impl.data.icudt40b.translit com.adobe.internal.pdf.tika com.adobe.internal.pdftoolkit.color com.adobe.internal.pdftoolkit.core.encryption com.adobe.internal.pdftoolkit.core.encryption.impl com.adobe.internal.pdftoolkit.core.traverser com.adobe.internal.pdftoolkit.graphicsDOM com.adobe.internal.pdftoolkit.graphicsDOM.shading com.adobe.internal.pdftoolkit.graphicsDOM.utils com.adobe.internal.pdftoolkit.image com.adobe.internal.pdftoolkit.pdf.content com.adobe.internal.pdftoolkit.pdf.content.processor com.adobe.internal.pdftoolkit.pdf.content.processor.base14fontwidths com.adobe.internal.pdftoolkit.pdf.contentmodify com.adobe.internal.pdftoolkit.pdf.contentmodify.impl com.adobe.internal.pdftoolkit.pdf.digsig com.adobe.internal.pdftoolkit.pdf.document com.adobe.internal.pdftoolkit.pdf.document.listener com.adobe.internal.pdftoolkit.pdf.document.permissionhandlers com.adobe.internal.pdftoolkit.pdf.filters com.adobe.internal.pdftoolkit.pdf.graphics com.adobe.internal.pdftoolkit.pdf.graphics.colorspaces com.adobe.internal.pdftoolkit.pdf.graphics.colorspaces.cmykresources com.adobe.internal.pdftoolkit.pdf.graphics.font com.adobe.internal.pdftoolkit.pdf.graphics.font.encodings com.adobe.internal.pdftoolkit.pdf.graphics.font.impl com.adobe.internal.pdftoolkit.pdf.graphics.impl com.adobe.internal.pdftoolkit.pdf.graphics.optionalcontent com.adobe.internal.pdftoolkit.pdf.graphics.patterns com.adobe.internal.pdftoolkit.pdf.graphics.shading com.adobe.internal.pdftoolkit.pdf.graphics.xobject com.adobe.internal.pdftoolkit.pdf.impl com.adobe.internal.pdftoolkit.pdf.inlineimage com.adobe.internal.pdftoolkit.pdf.interactive com.adobe.internal.pdftoolkit.pdf.interactive.action com.adobe.internal.pdftoolkit.pdf.interactive.annotation com.adobe.internal.pdftoolkit.pdf.interactive.forms com.adobe.internal.pdftoolkit.pdf.interactive.forms.impl com.adobe.internal.pdftoolkit.pdf.interactive.geospatial com.adobe.internal.pdftoolkit.pdf.interactive.markedcontent com.adobe.internal.pdftoolkit.pdf.interactive.navigation com.adobe.internal.pdftoolkit.pdf.interactive.navigation.collection com.adobe.internal.pdftoolkit.pdf.interactive.readerrequirements com.adobe.internal.pdftoolkit.pdf.interactive.requirement com.adobe.internal.pdftoolkit.pdf.interchange com.adobe.internal.pdftoolkit.pdf.interchange.documentparts com.adobe.internal.pdftoolkit.pdf.interchange.metadata com.adobe.internal.pdftoolkit.pdf.interchange.prepress com.adobe.internal.pdftoolkit.pdf.interchange.structure com.adobe.internal.pdftoolkit.pdf.multimedia com.adobe.internal.pdftoolkit.pdf.page com.adobe.internal.pdftoolkit.pdf.rendering com.adobe.internal.pdftoolkit.pdf.transparency com.adobe.internal.pdftoolkit.pdf.utils com.adobe.internal.pdftoolkit.services.Jpeg2000 com.adobe.internal.pdftoolkit.services.fontresources com.adobe.internal.pdftoolkit.services.fontresources.subsetting com.adobe.internal.pdftoolkit.services.interchange.structure com.adobe.internal.pdftoolkit.services.optionalcontent com.adobe.internal.pdftoolkit.services.optionalcontent.impl com.adobe.internal.pdftoolkit.services.pdfParser com.adobe.internal.pdftoolkit.services.permissions com.adobe.internal.pdftoolkit.services.rasterizer com.adobe.internal.pdftoolkit.services.readingorder com.adobe.internal.pdftoolkit.services.security com.adobe.internal.pdftoolkit.services.swf com.adobe.internal.pdftoolkit.services.textextraction com.adobe.internal.pdftoolkit.services.textextraction.impl com.adobe.internal.pdftoolkit.services.xmp com.adobe.internal.util.base64 com.adobe.internal.xmp.utils com.day.crx.core.cluster com.day.crx.packaging com.day.crx.packaging.gfx com.day.crx.query com.day.crx.sling.server.jmx com.day.durbo com.day.durbo.io com.day.imageio.plugins org.apache.aries.jmx.codec org.h2.mvstore org.h2.mvstore.rtree org.h2.mvstore.type org.openxmlformats.schemas.drawingml.x2006.chart.impl org.openxmlformats.schemas.drawingml.x2006.main.impl org.openxmlformats.schemas.drawingml.x2006.picture.impl org.openxmlformats.schemas.drawingml.x2006.spreadsheetDrawing.impl org.openxmlformats.schemas.drawingml.x2006.wordprocessingDrawing.impl org.openxmlformats.schemas.officeDocument.x2006.customProperties.impl org.openxmlformats.schemas.officeDocument.x2006.docPropsVTypes.impl org.openxmlformats.schemas.officeDocument.x2006.extendedProperties.impl org.openxmlformats.schemas.officeDocument.x2006.relationships.impl org.openxmlformats.schemas.presentationml.x2006.main.impl org.openxmlformats.schemas.spreadsheetml.x2006.main.impl org.openxmlformats.schemas.wordprocessingml.x2006.main.impl org.openxmlformats.schemas.xpackage.x2006.contentTypes org.openxmlformats.schemas.xpackage.x2006.contentTypes.impl org.openxmlformats.schemas.xpackage.x2006.digitalSignature org.openxmlformats.schemas.xpackage.x2006.digitalSignature.impl org.openxmlformats.schemas.xpackage.x2006.metadata.coreProperties org.openxmlformats.schemas.xpackage.x2006.metadata.coreProperties.impl org.openxmlformats.schemas.xpackage.x2006.relationships org.openxmlformats.schemas.xpackage.x2006.relationships.impl com.adobe.internal.afml com.adobe.internal.agm com.adobe.internal.pdftoolkit.legacy.services.ap.es2 com.adobe.internal.pdftoolkit.legacy.services.ap.es3 com.adobe.internal.pdftoolkit.pdf.pieceinfo.compoundtype com.adobe.internal.pdftoolkit.pdf.pieceinfo.editablepdf com.adobe.internal.pdftoolkit.services.ap com.adobe.internal.pdftoolkit.services.ap.annot com.adobe.internal.pdftoolkit.services.ap.extension com.adobe.internal.pdftoolkit.services.ap.impl com.adobe.internal.pdftoolkit.services.ap.spi com.adobe.internal.pdftoolkit.services.digsig com.adobe.internal.pdftoolkit.services.digsig.cryptoprovider com.adobe.internal.pdftoolkit.services.digsig.docmodanalysis com.adobe.internal.pdftoolkit.services.digsig.spi com.adobe.internal.pdftoolkit.services.fdf com.adobe.internal.pdftoolkit.services.formflattener com.adobe.internal.pdftoolkit.services.forms com.adobe.internal.pdftoolkit.services.imageconversion com.adobe.internal.pdftoolkit.services.javascript com.adobe.internal.pdftoolkit.services.javascript.extension com.adobe.internal.pdftoolkit.services.manipulations com.adobe.internal.pdftoolkit.services.manipulations.impl com.adobe.internal.pdftoolkit.services.optimizer com.adobe.internal.pdftoolkit.services.pdfa com.adobe.internal.pdftoolkit.services.pdfa.error com.adobe.internal.pdftoolkit.services.pdfa2 com.adobe.internal.pdftoolkit.services.pdfa2.error com.adobe.internal.pdftoolkit.services.pdfa2.error.codes com.adobe.internal.pdftoolkit.services.pdfa3 com.adobe.internal.pdftoolkit.services.pdfport com.adobe.internal.pdftoolkit.services.portfolio com.adobe.internal.pdftoolkit.services.rcg com.adobe.internal.pdftoolkit.services.rcg.impl com.adobe.internal.pdftoolkit.services.redaction com.adobe.internal.pdftoolkit.services.redaction.handler com.adobe.internal.pdftoolkit.services.sanitization com.adobe.internal.pdftoolkit.services.xbm com.adobe.internal.pdftoolkit.services.xdp com.adobe.internal.pdftoolkit.services.xfa com.adobe.internal.pdftoolkit.services.xfa.form com.adobe.internal.pdftoolkit.services.xfatext com.adobe.internal.pdftoolkit.services.xfdf com.adobe.internal.pdftoolkit.services.xobjhandler com.adobe.internal.pdftoolkit.xml com.adobe.octopus.extract opennlp.tools.doccat opennlp.tools.entitylinker opennlp.tools.formats opennlp.tools.formats.ad opennlp.tools.formats.brat opennlp.tools.formats.convert opennlp.tools.formats.frenchtreebank opennlp.tools.formats.muc opennlp.tools.formats.ontonotes opennlp.tools.lemmatizer opennlp.tools.parser opennlp.tools.parser.chunking opennlp.tools.parser.lang.en opennlp.tools.parser.lang.es opennlp.tools.parser.treeinsert opennlp.tools.sentdetect opennlp.tools.sentdetect.lang opennlp.tools.sentdetect.lang.th opennlp.tools.stemmer opennlp.tools.stemmer.snowball opennlp.tools.tokenize.lang.en org.apache.commons.imaging.color org.apache.commons.imaging.common org.apache.commons.imaging.common.itu_t4 org.apache.commons.imaging.common.mylzw org.apache.commons.imaging.formats.bmp org.apache.commons.imaging.formats.dcx org.apache.commons.imaging.formats.gif org.apache.commons.imaging.formats.icns org.apache.commons.imaging.formats.ico org.apache.commons.imaging.formats.jpeg org.apache.commons.imaging.formats.jpeg.decoder org.apache.commons.imaging.formats.jpeg.exif org.apache.commons.imaging.formats.jpeg.iptc org.apache.commons.imaging.formats.jpeg.segments org.apache.commons.imaging.formats.jpeg.xmp org.apache.commons.imaging.formats.pcx org.apache.commons.imaging.formats.png org.apache.commons.imaging.formats.png.chunks org.apache.commons.imaging.formats.png.scanlinefilters org.apache.commons.imaging.formats.png.transparencyfilters org.apache.commons.imaging.formats.pnm org.apache.commons.imaging.formats.psd org.apache.commons.imaging.formats.psd.dataparsers org.apache.commons.imaging.formats.psd.datareaders org.apache.commons.imaging.formats.rgbe org.apache.commons.imaging.formats.tiff org.apache.commons.imaging.formats.tiff.constants org.apache.commons.imaging.formats.tiff.datareaders org.apache.commons.imaging.formats.tiff.fieldtypes org.apache.commons.imaging.formats.tiff.photometricinterpreters org.apache.commons.imaging.formats.tiff.taginfos org.apache.commons.imaging.formats.tiff.write org.apache.commons.imaging.formats.wbmp org.apache.commons.imaging.formats.xbm org.apache.commons.imaging.formats.xpm org.apache.commons.imaging.icc org.apache.commons.imaging.palette org.apache.commons.imaging.util com.adobe.dam.print.ids.utils com.day.cq.dam.api.reporting com.day.cq.dam.entitlement.api com.day.cq.dam.handler.standard.epub com.day.cq.dam.handler.standard.keynote com.day.cq.dam.handler.standard.mp3 com.day.cq.dam.handler.standard.msoffice com.day.cq.dam.handler.standard.msoffice.wmf com.day.cq.dam.handler.standard.ooxml com.day.cq.dam.handler.standard.pdf com.day.cq.dam.handler.standard.pict com.day.cq.dam.handler.standard.ps com.day.cq.dam.handler.standard.psd com.day.cq.dam.handler.standard.zip com.day.cq.dam.word.extraction com.day.cq.dam.word.process com.adobe.xmp.worker.files com.adobe.cq.address.api com.adobe.cq.address.api.location com.day.cq.mcm.emailprovider.impl.types com.day.io com.day.io.disk com.day.io.file org.apache.commons.exec.environment org.apache.commons.exec.launcher org.apache.commons.exec.util com.google.zxing com.google.zxing.common com.google.zxing.common.reedsolomon com.google.zxing.qrcode.decoder com.google.zxing.qrcode.encoder com.adobe.cq.dam.dm.internalapi.image_server com.day.cq.dam.api.s7dam.jobs com.day.cq.dam.api.s7dam.omnisearch com.day.cq.dam.api.s7dam.scene7 com.day.cq.dam.scene7 com.day.cq.dam.scene7.api.net com.day.cq.analytics.sitecatalyst.rsmerger com.day.cq.searchpromote com.day.cq.searchpromote.xml com.day.cq.searchpromote.xml.form com.day.cq.searchpromote.xml.result> |
Legacy AEM 6.x API. |
| org.apache.sling.discovery.commons org.apache.sling.discovery.commons.providers org.apache.sling.discovery.commons.providers.base org.apache.sling.discovery.commons.providers.spi org.apache.sling.discovery.commons.providers.spi.base org.apache.sling.discovery.commons.providers.util |
This API is not supported in Cloud Service. |
| org.apache.jackrabbit.vault.util.xml org.apache.jackrabbit.vault.util.xml.serialize |
Util Classes related to Apache Xerces are removed in subsequent releases causing a major version change. Because these utils are for internal use in File vault, the API is getting deprecated from the public API surface. |
| org.apache.sling.atom.taglib org.apache.sling.atom.taglib.media |
Legacy AEM 6.x API. See removal notes below. |
| org.apache.sling.commons.log.logback org.apache.sling.commons.log.logback.webconsole |
AEM as a Cloud Service does not support this internal log back API. |
| com.github.jknack.handlebars.js | Handlebars upgrade required from 4.0.5 to 4.3.0 due to a security vulnerability. This package is no longer present in the upgraded handlebars. |
| com.adobe.granite.resourceresolverhelper | This API is not supported anymore. Use org.apache.sling.api.resource.ResourceResolverFactory instead. |
| org.apache.sling.repoinit.jcr org.apache.sling.repoinit.parser.operations |
Usage of this API is not supported in AEM as a Cloud Service. |
| org.apache.jackrabbit.oak.cache | This API is internal use only. |
API Removal Guidance api-removal-guidance
This section reflects API removal guidance for various APIs in the tables above.
Removal of org.apache.sling.commons.auth* org.apache.sling.commons.auth
If you are using org.apache.sling.commons.auth, or org.apache.sling.commons.auth.spi, or both, the usage can be replaced by migrating the code to org.apache.sling.auth resp. org.apache.sling.auth.spi. If you are using an old version of , make sure to update to the latest version.
Action list:
- Update ACS AEM Commons to latest version (at least 6.11.0)
- Migrate from
org.apache.sling.commons.authand/ororg.apache.sling.commons.auth.spitoorg.apache.sling.authresp.org.apache.sling.auth.spi.
Removal of org.apache.felix.webconsole* org.apache.felix.webconsole
If you using packages from org.apache.felix.webconsole*, remove this code from your project. The webconsole is not accessible in Cloud Service.
Action list:
- Remove code using packages from
org.apache.felix.webconsole*
Removal of org.eclipse.jetty* org.eclipse.jetty
If you use anything from the package org.eclipse.jetty or one of its sub packages, you might want to migrate to other third-party libraries with a similar functionality. If migration is not feasible, add the required bundles from the below list to your project.
Action list:
-
Replace usage of
org.eclipse.jettypackages with other third-party libraries/own code or -
Select the required bundles from this list and add them to your project:
org.eclipse.jetty:jetty-client:9.4.54.v20240208org.eclipse.jetty:jetty-http:9.4.54.v20240208org.eclipse.jetty:jetty-io:9.4.54.v20240208org.eclipse.jetty:jetty-security:9.4.54.v20240208org.eclipse.jetty:jetty-servlet:9.4.54.v20240208org.eclipse.jetty:jetty-server:9.4.54.v20240208org.eclipse.jetty:jetty-util:9.4.54.v20240208org.eclipse.jetty:jetty-util-ajax:9.4.54.v20240208
Removal of com.mongodb com.mongodb
Add the Mongo client API to your project.
Action list:
- Add this bundle to your project
org.mongodb:mongo-java-driver:3.12.7
You might want to pick a different version, depending on your requirements.
Removal of com.google.common* com.google.common
Remove the usage of Google Guava Core Libraries or include an appropriet version in your project. In many cases the usage of this library can be replaced with either collection classes from the JDK or Apache Commons Collections4. If you do not find any replacement, include the latest version of the Google Guave Core Library in your project. If you are using an old version of , make sure to update to the latest version.
Action list:
- Update ACS AEM Commons to latest version (at least 6.11.0)
- Replace usage of Google Guava Core Library with JDK collections or Apache Commons Collections4
- If still required, add this bundle to your project (substitute the version with the latest available):
com.google.guava:guava:33.4.8-jre
Removal of Apache Commons Lang 2 and Apache Commons Collections 3 apache.commons
Remove usage of the non maintained Apache Commons libraries and replace them with usage of the support versions. In most cases this just requires to adjust package imports, only in some cases classes or methods have been renamed. If you are using an old version of , make sure to update to the latest version.
Action list:
- Update ACS AEM Commons to latest version (at least 6.11.0)
- Replace imports of
org.apache.commons.lang*withorg.apache.commons.lang3 - Replace imports of
org.apache.commons.collections*withorg.apache.commons.collecitons4
Usage of org.apache.abdera* and org.apache.sling.atom.taglib org.apache.abdera_or_org.apache.sling.atom.taglib
Replace the usage of any package from org.apache.abdera and org.apache.sling.atom.taglib with a third-party library providing similar functionality or your own code.
Action list:
- Replace usage of packages from
org.apache.abderaandorg.apache.sling.atom.taglibwith other third-party libraries/own code.
Usage of org.apache.felix.http.whiteboard org.apache.felix.http.whiteboard
Replace the usage of org.apache.felix.http.whiteboard with the . The official OSGi API has similar capabilities and replacing most often only requires to change the service registration properties.
Action list:
- Replace the usage of
org.apache.felix.http.whiteboardwith
Usage of ch.qos.logback* ch.qos.logback
Logback is not supported in Cloud Service, remove all usage of it. If you are using an old version of , make sure to update to the latest version.
Action list:
- Update ACS AEM Commons to latest version (at least 6.11.0)
- Remove the code using packages from
ch.qos.logback
Usage of org.slf4j.event and org.slf4j.spi org.slf4j
If you are using org.slf4j.event or org.slf4j.spi, remove all usage of it. If you are using an old version of , make sure to update to the latest version.
Action list:
- Update ACS AEM Commons to latest version (at least 6.11.0)
- Remove the code using
org.slf4j.eventandorg.slf4j.spi
Usage of org.apache.log4j org.apache.log4j
If you are using org.apache.log4j switch to either SLF4J (org.slf4j) or Log4J 2.x (org.apache.logging.log4j).
Action list:
- Replace usage of
org.apache.log4jwith usingorg.slf4j(recommended) ororg.apache.logging.log4j
OSGI Configuration osgi-configuration
The sections below reflect the AEM as a Cloud Service OSGi configuration surface, describing what customers can configure.
- Customer code must not configure the listed OSGi configurations.
- A list of OSGi configurations whose properties may be configured, but must abide by the indicated validation rules. These rules include whether declaration of the property is required, its type, and in some cases, its allowed range of values.
Customer code may configure any OSGi configuration not listed.
These rules are validated during the Cloud Manager build process. Additional rules may be added over time and the expected enforcement date is noted in the table. Customers are expected to abide by these rules by the target enforcement date. Not abiding by the rules after the removal date generates errors in the Cloud Manager build process. Maven projects should include the AEM as a Cloud Service SDK Build Analyzer Maven Plugin to flag OSGI configuration errors during local SDK development.
Additional information about OSGI configuration can be found at this location.
Deprecated OSGi properties (soon to be unmodifiable) deprecated-unmodifiable-osgi-properties
Properties for the following OSGi component PIDs are deprecated and usage should stop by the enforcement date.
OSGI component ID
Unmodifiable Properties
Deprecation
Enforcement
org.apache.sling.commons.log.LogManagerall
4/24/25
8/31/25 (config ignored in June)
org.apache.sling.commons.log.LogManager.factory.configorg.apache.sling.commons.log.file, org.apache.sling.commons.log.pattern
4/24/25
8/31/25 (config ignored in June)
org.apache.sling.jcr.davex.impl.servlets.SlingDavExServletall
2024
8/31/25
com.adobe.granite.toggle.impl.dev.DynamicToggleProviderImplall
6/3/25
8/31/25
org.apache.http.proxyconfiguratorall
6/3/25
8/31/25
Unmodifiable OSGi properties unmodifiable-osgi-properties
Properties for the following OSGi component PIDs cannot be modified, as described below.
OSGI component ID
Unmodifiable Properties
com.day.cq.auth.impl.cug.CugSupportImplcom.day.cq.jcrclustersupport.ClusterStartLevelControllerall
com.adobe.granite.toggle.impl.ToggleRouterImplall
org.apache.sling.engine.impl.log.RequestLoggerFilterall
org.apache.sling.feature.apiregions.implall
org.apache.sling.jcr.resource.internal.helper.jcr.BinaryDownloadUriProviderall
com.adobe.cq.unifiedshell.impl.discovery.DiscoveryServletall
com.adobe.cq.unifiedshell.impl.ui.FrameErrorHandlerall
com.adobe.cq.unifiedshell.impl.config.UnifiedShellConfServiceall
com.adobe.cq.unifiedshell.impl.config.RepositoryIdentifierall
org.apache.sling.feature.apiregions.factoryall
com.adobe.granite.toggle.monitor.systempropertyall
Future enforced OSGi property restrictions future-restrictions-osgi-properties
In the future, 51黑料不打烊 will enforce the following OSGi properties restrictions so usage should stop.
OSGi component PID
Required
Type
Restriction (if applies)
com.day.cq.mailer.DefaultMailServicesmtp.hoststring
smtp.portYes
integer
either 鈥465鈥, 鈥587鈥 or 鈥25鈥
smtp.userstring
smtp.passwordstring
from.addressstring
smtp.sslstring
smtp.starttlsboolean
smtp.requiretlsboolean
debug.emailboolean
oauth.flowboolean
org.apache.sling.commons.log.LogManager.factory.configorg.apache.sling.commons.log.levelYes
string
either 鈥淚NFO鈥, 鈥淒EBUG鈥 or 鈥淭RACE鈥
org.apache.sling.commons.log.namesarray of strings
org.apache.sling.commons.log.additivboolean
com.day.cq.commons.impl.ExternalizerImplexternalizer.domainsNo
string[]
externalizer.encodedpathNo
boolean
externalizer.hostNo
string
externalizer.contextpathNo
string
OSGi property restrictions restrictions-osgi-properties
The values of these OSGi properties are restricted to the rules described below.
OSGi component PID
Required
Type
Restriction (if applies)
org.apache.felix.eventadmin.impl.EventAdminorg.apache.felix.eventadmin.ThreadPoolSizeYes
integer
2-100
org.apache.felix.eventadmin.AsyncToSyncThreadRatiodouble
鈥
org.apache.felix.eventadmin.AsyncToSyncThreadRatiointeger
鈥
org.apache.felix.eventadmin.RequireTopicboolean
鈥
org.apache.felix.eventadmin.IgnoreTimeoutYes
array of strings
Must include at least all of
org.apache.felix*, org.apache.sling*, come.day*, com.adobe*org.apache.felix.eventadmin.IgnoreTopicarray of strings
鈥
org.apache.felix.httporg.apache.felix.http.timeoutinteger
org.apache.felix.http.session.timeoutinteger
org.apache.felix.http.jetty.threadpool.maxinteger
org.apache.felix.http.jetty.headerBufferSizeinteger
org.apache.felix.http.jetty.requestBufferSizeinteger
org.apache.felix.http.jetty.responseBufferSizeinteger
org.apache.felix.http.jetty.maxFormSizeinteger
org.apache.felix.https.jetty.session.cookie.httpOnlyboolean
org.apache.felix.https.jetty.session.cookie.secureboolean
org.eclipse.jetty.servlet.SessionIdPathParameterNamestring
org.eclipse.jetty.servlet.CheckingRemoteSessionIdEncodingboolean
org.eclipse.jetty.servlet.SessionCookiestring
org.eclipse.jetty.servlet.SessionDomainstring
org.eclipse.jetty.servlet.SessionPathstring
org.eclipse.jetty.servlet.MaxAgeinteger
org.eclipse.jetty.servlet.SessionScavengingIntervalinteger
org.apache.felix.jetty.gziphandler.enableboolean
org.apache.felix.jetty.gzip.minGzipSizeinteger
org.apache.felix.jetty.gzip.compressionLevelinteger
org.apache.felix.jetty.gzip.inflateBufferSizeinteger
org.apache.felix.jetty.gzip.syncFlushboolean
org.apache.felix.jetty.gzip.excludedUserAgentsstring
org.apache.felix.jetty.gzip.includedMethodsarray of strings
org.apache.felix.jetty.gzip.excludedMethodsarray of strings
org.apache.felix.jetty.gzip.includedPathsarray of strings
org.apache.felix.jetty.gzip.excludedPathsarray of strings
org.apache.felix.jetty.gzip.includedMimeTypesarray of strings
org.apache.felix.http.session.invalidateboolean
org.apache.felix.http.session.container.attributearray of strings
org.apache.felix.http.session.uniqueidboolean
org.apache.sling.scripting.cacheorg.apache.sling.scripting.cache.sizeYes
integer
>= 2048
org.apache.sling.scripting.cache.additional_extensionsYes
array of strings
must include 鈥渏s鈥
org.apache.sling.engine.impl.log.RequestLoggerrequest.log.outputNo
string
request.log.outputtypeNo
string
request.log.entry.formatNo
string
request.log.exit.formatNo
string
request.log.enabledNo
string
access.log.outputNo
string
access.log.outputtypeNo
string
access.log.enabledNo
string
org.apache.sling.servlets.resolver.SlingServletResolverservletresolver.servletRootNo
string
servletresolver.cacheSizeNo
integer
servletresolver.pathsNo
string[]
servletresolver.defaultExtensionsNo
string
servletresolver.mountProvidersNo
boolean
servletresolver.scriptUserNo
string
deprecated, do not use
Java runtime update to version 21 java-runtime-update-21
51黑料不打烊 Experience Manager as a Cloud Service has transitioned to the Java 21 runtime. To ensure compatibility, updating library versions as outlined in Runtime requirements is essential.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab