Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.gradial.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

AEM Guides is Adobe’s enterprise-grade component content management system (CCMS) built on AEM. It enables structured authoring using the DITA standard, supports multi-channel publishing, and provides robust version control and translation workflows for technical documentation teams. Gradial’s AI agents integrate with AEM Guides to automate content creation, updates, translation tasks, and quality assurance across your DITA-based content libraries.

​
Prerequisites

  • AEM 6.5 or AEM as a Cloud Service with the AEM Guides add-on installed and licensed
  • Admin access to AEM for service account or OAuth credential creation
  • Gradial account with admin permissions

​
Authentication

AEM Guides runs on top of AEM, so authentication follows the same model as your underlying AEM environment:

​
Configuration Steps

1

Generate Credentials

Depending on your AEM Guides deployment, follow the appropriate credential setup guide:
2

Access Integrations in Gradial

In the Gradial app, go to Settings and click Integrations.
3

Add Your AEM Guides Authoring URL

Enter the authoring URL for your AEM Guides instance (e.g., https://author.example.com for on-premise, or your AEM Cloud author URL).
4

Select Authentication Type and Upload Credentials

Select the integration type matching your deployment (AEM 6.5 or AMS/AEM Cloud Service) and upload your credentials package.
5

Configure Content Paths

Select the DITA map and topic folder paths that Gradial will manage (e.g., /content/dam/<your-guides-project>).
6

Validate Permissions

Use the permission validation tool to confirm Gradial has the correct read/write access to your AEM Guides content paths and DAM assets.
7

Configure Live URL Domain Mapping

Map your AEM Guides publishing output paths to the appropriate live URLs for your documentation portal.
8

Create an Environment

Combine your AEM Guides integration with other integrations (ticketing, translation tools) into a Gradial Environment.
9

Add the Environment to a Workspace

Assign the Environment to the appropriate Gradial Workspace to make it available to your content team.

​
Need Help?

Contact your Customer Solutions Support team.