About this guide
- Topics:
- Introduction
CREATED FOR:
- Experienced
- Admin
Adobe Experience Manager Guides (later referred as AEM Guides) is a powerful, enterprise-grade component content management solution (CCMS). It enables native DITA support in Adobe Experience Manager, empowering AEM to handle DITA-based content creation and delivery. It empowers authors to create content using any offline DITA authoring tool, such as Adobe FrameMaker or an easy-to-use built-in Web Editor.
This guide provides the instructions to download, install, and configure AEM Guides. In this guide, you will find detailed instructions to set up AEM Guides as per your organizational authoring and publishing needs.
This guide is intended for the following type of audiences:
-
Administrators, who would install and manage AEM Guides on Adobe Experience Manager.
-
Publishers, who would run the publishing task to generate output in various formats.
Content structure
The information in this guide is organized as follows:
-
About this guide: This topic provides an introduction to this guide, intended audience, and how the information is organized in this guide.
-
Download and install: This topic describes how to download, install, or upgrade AEM Guides.
-
User administration and security: This topic describes the core concept of users and authentication in AEM and the default user groups created by AEM Guides.
-
Use custom DITA-OT and DITA specialization: This topic explains how to configure custom DITA-OT plug-ins and use DITA specialization.
-
Configure document states: This topic explains how to configure custom states for your DITA documents.
-
Migrate existing content: This topic describes how to on-board your existing content on AEM repository.
-
Configure filenames: This topic explains how to configure setting to automatically assign file names and define regex for valid file name characters.
-
Configure topic and map templates: This topic describes how to configure topic and map templates to meet your authoring needs. Learn about tagging system in AEM and how to configure tags to work with AEM Guides.
-
Customize Web Editor: This topic explains the various customizations that you can make in the Web Editor to enhance its functionality.
-
Set the Advanced Map Editor as default: This topic explains how to configure the Advanced Map Editor as the default editor for map files.
-
Include @navtitle attribute by default: This topic explains how to add the
@navtitleattribute to a reference file in a map by default. -
Configure global or folder-level profiles: This topic explains the process of creating folder profiles and giving permissions to specific users.
-
Version management: This topic describes how to configure automatic file checkout for files that are opened for editing in the Web Editor.
-
Integrate desktop-based XML editors: This topic describes the settings you need to enable editing documents in an external XML editor.
-
Configure output generation settings: This topic describes the various configurations that you can make to customize the default output generation process.
-
Configure and customize workflows: This topic describes the various configurations to customize the default workflows shipped in AEM Guides.
-
Translate content: This topic provides links to the relevant Help articles in AEM documentation to help you understand and configure the translation framework. Also, learn how to enable component-based translation workflow.
-
Configure search for AEM Assets UI: This topic describes how to configure DITA content search in Assets UI and add your custom attributes in search.
Additional resources
Following is a list of other helpful resources of AEM Guides, which are available on the Learn & Support page:
- User Guide
- API Reference Guide
- Quick Start Guide
- Help Archival Page (access older release documentation)
Experience Manager
- AEM Guides overview
- Disclaimer
- Release Information
- AEM Guides releases roadmap
- Release Notes
- Cloud Services
- Deployment Instructions
- 2025 Releases
- 2024 Releases
- 2023 Releases
- 2022 Releases
- On-prem/Managed Services
- Cloud Services
- User Guide (New UI)
- Introduction
- Home page
- Author content
- Authoring overview
- Ways to Author content using AEM Guides
- Editor
- Introduction to the Editor
- Launch the Editor
- Edit topics in the Editor
- Topic creation and preview
- Know the Editor features
- Additional features in the Editor
- Keyboard shortcuts in the Editor
- Editor views
- Support for Schematron files
- Author Markdown documents from the Editor
- Add citations to your content
- Use data from your data sources
- Document state
- Use labels
- Map Editor
- DITAVAL editor
- Desktop tools for authoring content
- Review content
- Collaborate using Adobe Workfront
- Metadata and tagging
- Map management and publishing
- Map console overview
- Open files in Map console
- Reports
- Content translation
- Output Generation
- Output generation basics
- Output presets in AEM Guides
- Edit, duplicate, or delete an output preset
- Conditionalize content
- Use Baseline
- Manage Global and Folder Profile output presets
- Use variables for setting the Destination Path, Site Name, or File Name options
- Pass on the metadata to the output using DITA-OT
- Generate output
- Use Map Collection for output generation
- Manage output generation process
- Manage publish tasks using the Publish Dashboard
- Basic troubleshooting
- Bulk activation of content
- Output generation of FrameMaker Documents
- AI Assistant in AEM Guides
- Appendix
- User Guide (Old UI)
- Installation and configuration
- On-premise
- On-premise basics
- Download, install, and upgrade
- Work with user groups and security
- Content migration
- Work with custom DITA-OT and specialization
- Configure post processing for a folder
- Configure filenames
- Configure auto-filenames based on UUID
- Configure Regx for valid file name characters
- Configure valid file names for AEM Site output
- Work with topic and map templates
- Work with document states
- Work with the Web Editor configurations
- Customize Web Editor
- Customize toolbar
- Configure default value for the Tags View
- Configure the title for Check in and Check out icons
- Configure display of UUID-based links
- Open DITA topic or map files in same tab
- Configure a custom panel in the left panel
- Configure file auto-save in the Web Editor
- Configure filters for file browse dialog
- Configure prompt to save as a new version on close
- Configure prompt to check in a file on close
- Configure allowed special characters
- Auto-generate element IDs
- Customize AEM’s default dictionary
- Configure text filters
- Configure the number of LimitReads for a query
- Install packages for Article-based publishing
- Configure a data source connector from the user interface
- Set the Advanced Map Editor as default
- Include @navtitle attribute by default
- Configure the option to edit in Oxygen
- Configure additional special characters
- Work with global and folder-level profiles
- Configure versions
- Work with desktop-based XML editors
- Work with output generation settings
- Configure output generation settings
- Download and install aem sites templates
- Overlay HTML tags in AEM Sites output
- Native PDF Publishing
- Configure JVM flags for Native PDF Publishing
- Configure and customize workflows
- Work with translation configurations
- Work with AEM Assets search
- Appendix
- Cloud Services
- About this guide
- Deploy and configure AEM Guides as Cloud Service
- Work with user groups and security
- Content migrate
- Work with custom DITA-OT and specialization
- Configure UUID and non-UUID based filenames
- Work with topic and map templates
- Work with document states
- Work with the Web Editor configurations
- Customize Web Editor
- Customize toolbar
- Configure the AI-powered smart suggestions for authoring
- Configure the AI-powered Smart Help to search content
- Configure default value for the Tags View
- Configure display of UUID-based links
- Configure display of pasted tables
- Open DITA topic or map files in same tab
- Configure a custom panel in the left panel
- Configure file auto-save in the Web Editor
- Configure prompt to save as a new version on close
- Configure prompt to check in a file on close
- Configure allowed special characters
- Auto-generate element IDs
- Customize AEM’s default dictionary
- Configure text filters
- Configure filters for file browse dialog
- Install packages for Article-based publishing
- Configure single topic PDF generation
- Configure Translation feature in the Web Editor
- Configure a data source connector
- Configure a data source connector from the user interface
- Set the Advanced Map Editor as default
- Include @navtitle attribute by default
- Work with global and folder-level profiles
- Configure versions
- Work with desktop-based XML editors
- Configure Workfront
- Work with output generation settings
- Work with custom workflows
- Work with translation configurations
- Work with AEM Assets search
- Appendix
- On-premise
- API Reference
- Introduction
- REST APIs for Output management
- REST API to work with DITA maps
- REST API to register a data source connector
- REST API to work with conditional attributes
- REST APIs for conversion workflow
- REST API for creating and activating packages
- Java-based API to work with output generation
- Java-based APIs to work with DITA maps
- Java-based APIs for conversion workflow
- Java-based APIs to work with baseline and labels
- Java-based API to work with folder profiles
- Java-based API for creating and activating packages
- Post-processing event handler
- Bulk activation complete event handler
- Conversion process event handler
- Knowledge Base
- Expert Session
- Expert Session Overview
- Translate content
- Manage content using baselines
- Author web-based content
- Native PDF publishing essentials
- Reports in AEM Guides
- Content and Template setup
- Learning native PDF publishing - part 1
- Learning native PDF publishing - Hands on lab - BYOS
- Extension Framework of AEM Guides
- External Datasource Integration
- Translate content in Guides - part 2
- Define, Manage and Utilize Metadata
- AEM Sites output variations
- Deployment options and migration to Cloud
- Migrate content from non-uuid to UUID
- Delta content migration
- Articles
- Authoring
- Guides Extention Framework
- External data source
- Publishing
- Workflows
- Translation
- Use Cases
- Expert Session
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 Guides at Summit
Register for these admin sessions:
- Elevate and Empower Teams with Agentic AI for Exceptional Experiences (attend online)
- Unlocking Content at Scale with Havas POP and Adobe GenStudio
- 3 Pillars of Purpose-driven Experiences: Trust, Data, and GenAI
- Revolutionizing Pharma Content Velocity & MLR with Automation & AI
- How Adobe Uses GenStudio to Supercharge Its Global Marketing Organization
Connect with Experience League at Summit!
Get front-row access to top sessions, hands-on activities, and networking—wherever you are!
Learn more
