Enable Feature Toggle on Adobe Experience Software Development Kit (AEM SDK)

Feature Toggle in AEM allows administrators to enable or disable features at runtime ideal for managing Early Adopter and Prerelease features without code changes. It supports gradual rollouts, A/B testing, and quick deactivation of unstable features.

This article covers how to enable feature toggles in AEM Local SDK setup, which simulates AEM as a Cloud Service using the SDK and Dispatcher. This setup helps teams test in a production-like environment before deploying to the cloud.

Why Use Feature Toggles in a AEM SDK Setup?

When working in a AEM SDK setup, feature toggles help in:

  • Testing experimental features safely.

  • Rolling out new components in phases.

  • Maintaining a single codebase across multiple environments.

  • Reducing risk during deployments and upgrades.

Prerequisites

Before enabling feature toggles in your AEM SDK setup, ensure the following:

  • User is member of forms-users group.

  • Navigate to http://<author-instance-url>:portnumber/system/console/bundles and check whether (com.adobe.granite.toggle.impl.dev-1.1.2.jar) bundle is present or not. In case it is not present download the bundle from the link.

    Feature Toggle

Enable Feature Toggle

Follow these steps to enable feature toggles in your AEM SDK instance:

  1. Log in to your AEM Forms instance.

  2. Navigate to http://author-instance-url:portnumber/system/console/configMgr.

  3. Search for Adobe Granite Dynamic Toggle Provider in the Configuration Manager.

    Feature Toggle

  4. Click the icon ✏️ .

  5. In the Enabled Toggles section, click➕ .

  6. Add the feature toggle id for the feature as shown in the image below.
    Feature Toggle

  7. Click Save

NOTE
You can find the feature toggle id in the document specific to the early adopter features.

Disable Feature Toggle

To disable the feature toggle(s) for features whose toggle(s) are enabled, follow the steps below:

  1. Log in to your AEM Forms instance.

  2. Navigate to http://author-instance-url:portnumber/system/console/configMgr.

  3. Search for Adobe Granite Dynamic Toggle Provider in the Configuration Manager.

  4. Click the icon ✏️.

  5. In the Disabled Toggles section, click ➕.

  6. Add the toggle number for the feature to be disabled.

    Feature Toggle

Technical Consideration

Feature toggles are runtime-managed and best suited for development or testing setups. In a AEM SDK setup, ensure toggles are version-controlled and synced with CI/CD. Page refresh or cache clearing may be needed for changes to reflect.

NOTE
To enable the feature toggle for the production environment, please contact the Adobe Support team.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab