Documentation AEM as a Cloud Service User Guide

Enable Adaptive Forms Core Components enable-headless-adaptive-forms-on-aem-forms-cloud-service

Last update: Thu Jun 26 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Applies to:
Experience Manager as a Cloud Service

CREATED FOR:

Admin
Developer
User

Version

Article link

AEM 6.5

Click here

AEM as a Cloud Service

This article

Enabling Adaptive Forms Core Components on AEM Forms as a Cloud Service, lets you start creating, publishing, and delivering Core Components based Adaptive Forms and Headless Forms using your AEM Forms Cloud Service instances to multiple channels. You require Adaptive Forms Core Components enabled environment to use Headless Adaptive Forms.

Considerations

When you create a fresh AEM Forms as a Cloud Service program, Adaptive Forms Core Components and Headless Adaptive Forms are already enabled for your environment.
If you have an older Forms as a Cloud Service program where Core Components are not enabled, you can add Adaptive Forms Core Components dependencies to your AEM as a Cloud Service repository and deploy the repository to your Cloud Service environments to enable Headless Adaptive Forms.
If your existing Cloud Service environment provides option to create Core Components-based Adaptive Forms, Adaptive Forms Core Components and Headless Adaptive Forms are already enabled for your environment and you can serve Core Component based Adaptive Forms as headless forms to channels such as mobile, web, native apps, and services that require a headless representation of Adaptive Forms.

Enable Adaptive Forms Core Components and Headless Adaptive Forms enable-headless-forms

Perform the following steps, in the listed order, to enable Adaptive Forms Core Components and Headless Adaptive Forms for an AEM Forms as a Cloud Service environment

Enable core components and headless adaptive forms

1. Clone your AEM Forms as a Cloud Service Git Repository clone-git-repository

Log in to Cloud Manager and select your organization and program.
Navigate to the Pipelines card from your Program Overview page, click the Access Repo Info button to access and manage your Git Repository. The page includes the following information:
- URL to the Cloud Manager Git Repository.
- Credentials of the Git Repository (Username and Password) Git username.
Click Generate Password to view or generate the password.

Open terminal or command prompt on your local computer and run the following command:

code language-shell
`git clone [Git Repository URL]`

When prompted, provide the credentials. The repository is cloned to your local computer.

2. Add Adaptive Forms Core Components dependencies to your Git Repository add-adaptive-forms-core-components-dependencies

Open your Git Repository folder in a plain text code editor. For example, VS Code.
Open the [AEM Repository Folder]\pom.xml file for editing.

Replace versions of the core.forms.components.version, core.forms.components.af.version and core.wcm.components.version components with versions specified in core components documentation. If the component does not exist, add these components.

code language-xml

code language-xml
`<!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags --> <properties> <core.wcm.components.version>2.22.10</core.wcm.components.version> <core.forms.components.version>2.0.18</core.forms.components.version> <core.forms.components.af.version>2.0.18</core.forms.components.af.version> </properties>`


<!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags -->

<properties>
    <core.wcm.components.version>2.22.10</core.wcm.components.version>
    <core.forms.components.version>2.0.18</core.forms.components.version>
    <core.forms.components.af.version>2.0.18</core.forms.components.af.version>
</properties>

Mention latest version of Forms Core Components

In the dependencies section of the [AEM Repository Folder]\pom.xml file, add the following dependencies, and save the file.

code language-xml

code language-xml
<!-- WCM Core Component Examples Dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <version>${core.wcm.components.version}</version> <type>zip</type> </dependency> <!-- End of WCM Core Component Examples Dependencies --> <!-- Forms Core Component Dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <!-- End of AEM Forms Core Component Dependencies -->


    <!-- WCM Core Component Examples Dependencies -->
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.apps</artifactId>
            <type>zip</type>
            <version>${core.wcm.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.content</artifactId>
            <type>zip</type>
            <version>${core.wcm.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.config</artifactId>
            <version>${core.wcm.components.version}</version>
            <type>zip</type>
        </dependency>
        <!-- End of WCM Core Component Examples Dependencies -->
        <!-- Forms Core Component Dependencies -->
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-core</artifactId>
            <version>${core.forms.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-apps</artifactId>
            <version>${core.forms.components.version}</version>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-af-core</artifactId>
            <version>${core.forms.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-af-apps</artifactId>
            <version>${core.forms.components.version}</version>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-apps</artifactId>
            <type>zip</type>
            <version>${core.forms.components.version}</version>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-content</artifactId>
            <type>zip</type>
            <version>${core.forms.components.version}</version>
        </dependency>
<!-- End of AEM Forms Core Component Dependencies -->

Open the [AEM Repository Folder]/all/pom.xml file for editing. Add the following dependencies in the <embeddeds> section and save the file.

code language-xml

code language-xml
<!-- WCM Core Component Examples Dependencies --> <!-- inside plugin config of filevault-package-maven-plugin --> <!-- embed wcm core components examples artifacts --> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <!-- embed forms core components artifacts --> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded>


<!-- WCM Core Component Examples Dependencies -->

<!-- inside plugin config of filevault-package-maven-plugin -->
<!-- embed wcm core components examples artifacts -->

<embedded>
    <groupId>com.adobe.cq</groupId>
    <artifactId>core.wcm.components.examples.ui.apps</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.cq</groupId>
    <artifactId>core.wcm.components.examples.ui.content</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.cq</groupId>
    <artifactId>core.wcm.components.examples.ui.config</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<!-- embed forms core components artifacts -->
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-af-apps</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/application/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-af-core</artifactId>
    <target>/apps/${appId}-vendor-packages/application/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-examples-apps</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>
<embedded>
    <groupId>com.adobe.aem</groupId>
    <artifactId>core-forms-components-examples-content</artifactId>
    <type>zip</type>
    <target>/apps/${appId}-vendor-packages/content/install</target>
</embedded>

note note

NOTE

Replace ${appId} with your appId.

To find your ${appId}, in the [AEM Repository Folder]/all/pom.xml file, search the -packages/application/install term. The text before the -packages/application/install term is your ${appId}. For example, the following code, myheadlessform is ${appId}.

code language-none
`com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install`

In the <dependencies> section of the [AEM Repository Folder]/all/pom.xml file, add the following dependencies, and save the file:

code language-xml

code language-xml
<!-- Other existing dependencies --> <!-- wcm core components examples dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> </dependency> <!-- forms core components dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> </dependency>


        <!-- Other existing dependencies -->
        <!-- wcm core components examples dependencies -->
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.apps</artifactId>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.config</artifactId>
            <type>zip</type>
            </dependency>
        <dependency>
            <groupId>com.adobe.cq</groupId>
            <artifactId>core.wcm.components.examples.ui.content</artifactId>
            <type>zip</type>
        </dependency>
            <!-- forms core components dependencies -->
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-af-apps</artifactId>
            <type>zip</type>
        </dependency>
        <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-apps</artifactId>
            <type>zip</type>
        </dependency>
            <dependency>
            <groupId>com.adobe.aem</groupId>
            <artifactId>core-forms-components-examples-content</artifactId>
            <type>zip</type>
        </dependency>

Open the [AEM Repository Folder]/ui.apps/pom.xml for editing. Add the af-core bundle dependency, and save the file.

code language-xml
`<dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>`

note note
NOTE
Ensure that the following Adaptive Forms Core Components artifacts are not included in your project.
`<dependency>`
`<groupId>com.adobe.aem</groupId>` `<artifactId>core-forms-components-apps</artifactId>`
`</dependency>`
and
`<dependency>`
`<groupId>com.adobe.aem</groupId>` `<artifactId>core-forms-components-core</artifactId>`
`</dependency>`

Save and close the file.

3. Build and deploy the updated code

Deploy the updated code to your local development and Cloud Service environments to enable the Core Components on both the environments:

Build and deploy updated code on a local development environment (AEM as a Cloud Service SDK)
Build and deploy updated code on an AEM Forms as a Cloud Service environment

Build and deploy updated code on a local development environment core-components-on-aem-forms-local-sdk

Open the command prompt or terminal.
Navigate to the root directory of your Git Repository project.

Run the following command to build the package for your environment:

code language-shell
`mvn clean install`

After the package is successfully built, you can find it at [Git Repository Folder]\all\target[appid].all-[version].zip

Use the Package Manager to deploy the [AEM Archetype Project Folder]\all\target[appid].all-[version].zip package on local development environment.

Build and deploy updated code on an AEM Forms as a Cloud Service environment core-components-on-aem-forms-cs

Open the terminal or command prompt.

Navigate to your [AEM Repository Folder] and run the following commands in the listed order

code language-shell
`git add pom.xml git add all/pom.xml git add ui.apps/pom.xml git commit -m "Added dependencies for Adaptive Forms Core Components" git push origin`

After the files are committed to Git Repository, Run the pipeline.

After pipeline run is successful, Adaptive Forms Core Components are enabled for the corresponding environment. Also, an Adaptive Forms (Core Components) template and Canvas 3.0 theme are added to your Forms as a Cloud Service environment, providing you with options to customize and create Core Components based Adaptive Forms.

Frequently Asked Questions faq

What are core components? core-components

The Core Components are a set of standardized Web Content Management (WCM) components for AEM to speed up development time and reduce maintenance cost of your websites.

What all capabilities are added on enabling core components? core-components-capabilities

When the Adaptive Forms Core Components are enabled for your environment, a blank Core Components based Adaptive Form template and Canvas 3.0 theme are added to your environment. After enabling Adaptive Forms Core Components for your environment, you can:

Are Adaptive Forms Core Components enabled for my environment? enable-components

To check that Adaptive Forms Core Components are enabled for your environment:

Clone your AEM Forms as a Cloud Service repository.
Open the [AEM Repository Folder]/all/pom.xml file of your AEM Forms Cloud Service Git Repository.
Search for the following dependencies:
- core-forms-components-af-core
- core-forms-components-core
- core-forms-components-apps
- core-forms-components-af-apps
- core-forms-components-examples-apps
- core-forms-components-examples-content
If the dependencies exist, Adaptive Forms Core Components are enabled for your environment.

Why do Core Component-based forms fail to render in project?

Core Component-based forms may fail to render due to a version mismatch between the Forms Core Components package and the version included in the project archetype. This issue typically occurs when the version specified in the project archetype is equal to or higher than the version bundled with the Forms Core Components package. To resolve this issue, do one of the following:

Use a lower version of the Forms Core Components package in the project archetype.
Remove the Forms Core Components dependency from the project archetype, as the required version is already included with AEM as a Cloud Service. The Forms Core Components package is bundled with AEM as a Cloud SDK starting from release 20133, for example, AEM SDK v2025.3.20133.20250325T063357Z-250300.

recommendation-more-help

fbcff2a9-b6fe-4574-b04a-21e75df764ab