The Environment Badge is a lightweight visual utility designed for the AEM Authoring UI. It provides instant identification of the active program and environment, mitigating the risk of performing configurations or content authoring in the wrong instance.

• Visual indicators: Renders a high-visibility badge and a context bar within the AEM Authoring UI and CRX Explorer.
• Unified Shell compatibility: Designed to work seamlessly with or without the AEM Unified Shell.
• Browser tab identification: Optionally prefixes the document title to help users manage multiple open environments in browser tabs.
• Environment specific configuration: Leverages OSGi and environment variables to allow unique identification of tiers.

Feature	Description	Preview
Badge	Displays a configurable title and background color. If no title is set, only the conetxt bar remains visible.
Document title prefix	Prefixes the tab title: <PREFIX> | <DOCUMENT TITLE>
Color palette	Predefined set of colors available

Add the aem-environment-badge.all artifact to the <dependencies> section

<dependency>
    <groupId>com.merkle.oss.aem</groupId>
    <artifactId>aem-environment-badge.all</artifactId>
    <version>1.0.0</version>
    <type>zip</type>
</dependency>

Embed the package into your all deployment module using the filevault-package-maven-plugin:

<embedded>
    <groupId>com.merkle.oss.aem</groupId>
    <artifactId>aem-environment-badge.all</artifactId>
    <target>/apps/{your/install/path}/install</target>
</embedded>

Define an OSGi configuration scoped to your desired AEM environment using the following PID: com.merkle.oss.aem.environmentbadge.services.impl.AEMEnvironmentBadgeConfigServiceImpl.cfg.json

Pro-Tip: Leverage environment variables to allow different environments within the same tier to have unique identities, exceeding the capabilities of the OOTB Unified Shell indicator.

{
  "enableDocumentTitlePrefix": true,
  "documentTitlePrefix": "$[env:ENV_BADGE_DOC_TITLE_PREFIX;default=RDE]",
  "enableBadge": true,
  "badgeTitle": "$[env:ENV_BADGE_TITLE;default=rde]",
  "badgeBackgroundColor": "fuchsia"
}

Build the full package

    mvn clean install -PautoInstallBundle

Build and deploy the full package to a local AEM Author:

    mvn clean install -PautoInstallPackage

This tool requires AEM Version 2025.9.x or higher.

• AEM as a Cloud Service (AEMaaCS): This tool is primarily designed and optimized for Cloud Service environments.
• AEM On-Premise / Adobe Managed Services: While the codebase is compatible with standard AEM On-Premise installations, please note that it has not been formally tested in these environments.