Mark Your Calendars
Feature releases are scheduled well in advance and the feature release activation dates are published on Adobe Experience League.
Take note of the release dates so you can plan time to review and test the upcoming features.
Review the Release Notes
Once you have the release dates marked in your calendar, be sure to check the Adobe Experience League website on the day of the release for the latest release notes.
Each release is accompanied by release notes that document not only what is new in that release, but also the features that are available for prerelease evaluation. Get in the know ahead of time, and plan to take advantage of the latest features from AEMaaCS!
You can also check the known issues that are published along with every release so you can also be aware of any technical issues that may present a challenge to your evaluation or eventual adoption of any new features.
Enable the Prerelease Channel to Access and Try New Features
The prerelease channel can be enabled on any development or sandbox environment. Prerelease cannot be enabled on staging or production environments.
The prerelease features can be experienced in different ways:
Cloud Environments
To update a cloud environment to use the prerelease, you must add a new environment variable. You can do this either using the Cloud Manager UI or via CLI.
Add Environment Variable Using the UI
-
Log into Cloud Manager at my.cloudmanager.adobe.com and select the appropriate organization.
-
Navigate to the program where you want to enable prerelease.
-
Select the environment where you want to enable prerelease and access its configuraiton via Program > Environment > Environment Configuration.
-
Add a new environment variable
Name Value Service Applied Type AEM_RELEASE_CHANNEL
prerelease
All Variable -
Save the changes and the environment will refresh with prerelease feature toggles enabled.
Add Environment Variable Using the CLI
You can also use the Cloud Manager API and CLI to update the environment variables.
-
Using Cloud Manager API’s environment variables endpoint, set the
AEM_RELEASE_CHANNEL
environment variable to the valueprerelease
.PATCH /program/{programId}/environment/{environmentId}/variables [ { "name" : "AEM_RELEASE_CHANNEL", "value" : "prerelease", "type" : "string" } ]
-
The Cloud Manager CLI can also be used
aio cloudmanager:environment:set-variables <ENVIRONMENT_ID> --programId=<PROGRAM_ID> --variable AEM_RELEASE_CHANNEL "prerelease
The variable can be deleted or set back to a different value if you want the environment to be restored to the behavior of the regular (non-prerelease) channel.
Local SDK
You can see new features in the Sites console in the local Quickstart SDK and code against new APIs in the prerelease by configuring your Maven project to reference the prerelease API Jar
located in Maven Central. You can also see these prerelease features in your local development environment by starting the regular Quickstart SDK in prerelease mode.
Start Quickstart SDK in Prerelease Mode
- Download the SDK from the software distribution portal and install as described in Accessing the AEM as a Cloud Service SDK.
- When launching the SDK Quickstart, include the argument
-r prerelease
.
The value is sticky so it can only be selected on the first startup. Reinstall the SDK to change the command-line option.
Since there may be multiple AEM maintenance releases between monthly feature releases, you can download these new SDKs and reference the new SDK API Jar versions in maven projects. The maintenance releases will not add additional prerelease features, but could include other smaller changes such as bug fixes, security fixes, and performance enhancements.
Javadocs are published to Maven Central.
Build Against the Prerelease SDK
-
Modify your maven project’s
pom.xml
to reference a distinct prerelease SDK API jar, which is published to Maven Central. It contains any new Java API for the prerelease features and has a dependency on the SDK API jar. It uses the same version.As an example, here is a snippet from the parent pom’s dependency management section referencing the regular API jar:
<dependencyManagement> <dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-sdk-api</artifactId> <version>${aem.sdk.api}</version> <scope>provided</scope> </dependency>
And then the usage in a module:
<dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-sdk-api</artifactId> </dependency>
To change to the prerelease SDK, simply change the dependency from
com.adobe.aem:aem-sdk-api
tocom.adobe.aem:aem-prerelease-sdk-api
as noted below:<dependencyManagement> <dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-prerelease-sdk-api</artifactId> <version>${aem.sdk.api}</version> <scope>provided</scope> </dependency> <dependencies> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>aem-prerelease-sdk-api</artifactId> </dependency>
As usual, individual projects can use the dependency.
-
Deploy to your local server.
-
If satisfied that it works as expected locally, commit code to a development branch and use a Cloud Manager non-production pipeline to deploy to an environment that subscribes to the prerelease channel.
aem-prerelease-sdk-api
artifactId must never be used when deploying to stage or production. Always user the aem-sdk-api
when deploying via the production pipeline. Similarly, code that references prerelease APIs should not be deployed via the production pipeline.The AEM CS SDK build Analyzer maven plugin v1.0 and higher will detect if the prerelease API is used in a project by inspecting the dependencies. If the analyzer finds it, it will use the prerelease SDK API to analyze the project.
Train Your Users
Once you have tested the new features in the prerelease channel and have decided to use them in your projects, you need to train your users.
Adobe Experience League offers lots of resources to learn AEMaaCS.
- The AEMaaCS documentation
- Tutorials
- The monthly release overview video in the release notes
Considerations
There are a few items to note when using the prerelease channel.
- The prerelease channel does not necessarily contain all new features to be rolled out in the following release.
- Features in the prerelease are put through rigorous quality assurance and intended to be feature complete rather than beta quality. If you notice any issues, report them, just as you would do if you suspect bugs in features in a regular AEM release.
- To determine if an environment is configured for the prerelease channel, go to the AEM console’s About page and check if the AEM version number includes a prerelease suffix such as
Adobe Experience Manager 2021.4.5226.20210427T070726Z-210429-PRERELEASE
.
The Perfect Blend: A New Era of Collaboration with AEM and Workfront
Adobe Customer Success Webinars
Wednesday, Apr 2, 5:00 PM UTC
Explore how Adobe Experience Manager and Workfront integrate to help teams move from ideation to delivery without the usual bottlenecks, ensuring content is organized, on-brand, and ready to go live faster.
RegisterAdobe Experience Manager at Summit
Register for these admin sessions:
- Elevate and Empower Teams with Agentic AI for Exceptional Experiences (attend online)
- How Adobe Uses GenStudio to Supercharge Its Global Marketing Organization
- Revolutionizing Pharma Content Velocity & MLR with Automation & AI
- Unlocking Content at Scale with Havas POP and Adobe GenStudio
- 3 Pillars of Purpose-driven Experiences: Trust, Data, and GenAI
Connect with Experience League at Summit!
Get front-row access to top sessions, hands-on activities, and networking—wherever you are!
Learn more