Adobe Experience Manager Guides

Test

Please ping me at John@syncpointdigital.com if you are interested in learning more. 

Adobe DITAWORLD 2026Join us for Adobe DITAWORLD 2026Three days. One global stage for the future of technical content.Join us at Adobe DITAWORLD 2026 for three days of inspiration, ideas, and innovation — featuring a stellar lineup of speakers from the world's leading brands. From real customer success stories to the latest in AI-powered authoring and structured content, there's something here for every technical communicator, content strategist, and CCMS leader.Why you won't want to miss it:Hear how global enterprises are scaling content with Adobe Experience Manager Guides Explore the role of Generative AI in technical communication — from drafting to delivery Discover best practices in structured content, DITA, and omni-channel publishing Connect with peers, partners, and the Adobe Technical Communication teamRegister for freeCan't attend live? Register to receive the recording.

Complete Guide: AEM System User & Service User Mapping System users in AEM are used by backend services to access the repository securely without using an admin session. They are commonly used with the Sling ResourceResolverFactory to obtain a ResourceResolver.Using system users is a recommended security practice in modern AEM development.1. What is a System User in AEM?A System User is a non-login user used by services or backend code to access resources in the repository.Key Characteristics Cannot log in to AEM UI Used by backend services Has specific permissions (ACL) Works with Service User Mapping Why System Users Are ImportantOlder versions of AEM allowed: resourceResolverFactory.getAdministrativeResourceResolver()This method is now deprecated for security reasons. Instead, system users should be used.2. Architecture of Service User AccessTypical flow: AEM Service / Servlet / Scheduler↓ResourceResolverFactory↓Subservice Name↓Service User Mapping↓System User↓Repository A

Hi everyone,I’m working with the Search Panel Explorer in the AEM Editor interface, based on the documentation below:https://experienceleague.adobe.com/en/docs/experience-manager-guides/using/user-guide/author-content/work-with-editor/editor-interface-features/search-panel-explorerWhat I’m doingI’m adding custom search filters using the ui_config.json approach, similar to the solution described here:https://experienceleaguecommunities.adobe.com/adobe-experience-manager-guides-11/aem-guides-search-customization-not-working-as-documented-14210?postid=435242#post435242Using this method: I’m able to successfully add new filters to the Search Panel The custom Tags filter appears and functions correctly Issue I’m facingFor the custom Tags filter, I’m not able to restrict or configure the tag root path.Even after setting the desired root (for example /content/cq:tags/products), the Tags field still shows tags from the entire global tag tree instead of the expected subtree.My questions When

When using a custom post-generation workflow in AEM Guides Cloud, the UI notification becomes stuck on "In Progress - Generating <output>..." indefinitely. In my case, I was using a Native PDF output preset. Even though the success message "hangs," and the PDF is generated successfully, and the workflow completes without errors.I'm using AEM Guides as part of the cloud service.SymptomsPDF generation completes successfullyCustom workflow executes and completes (verified in logs)FinalizePostPublish step runs successfullyPDF file is created in /content/dam/fmdita-outputs/pdfs/BUT: UI notification stays stuck on "In Progress..." foreverNo success notification or download link appears Root Cause AnalysisAfter investigation, I discovered that the output history node shows two different status properties:Location of output history: /var/dxml/metadata/outputHistory/ <id> / <id> With Custom Workflow:cloudStatus: "Finished" outputStatus: "Post-Publishing" <--&

I am exploring native PDF publishing with AEM. Is there a way to modify the content using XSLT before the PDF is created? Or before the intermediate HTML is created? Thank you.

I published a DITA map using the AEM Sites output preset in AEM Guides. However:The navigation panel is missing in the generated output.The links that are visible in the generated output are not rendered on the published page. Kindly advise. Thanks

Hi,I am trying to create a few custom search filters onn the AEM Guides Search dialog, as explained in the documents: https://experienceleague.adobe.com/en/docs/experience-manager-guides/using/install-guide/cs-ig/web-editor-configs-cs/config-text-filtershttps://experienceleague.adobe.com/en/docs/experience-manager-guides/using/install-guide/on-prem-ig/web-editor-configs/conf-custom-file-filtersNOTE : i am trying this over a repository initialized with aem-cloud-sdk-quickstart-2024-11 and aem-guides cloud package 2025.02i did enable metadata extraction in the system/console/configMgr, and ran the "Extract DITA Metada" over the DAM folder where my DITA topics and maps exist; and i do see the extracted metadata under the jcr:content/ditameta node of every topic.however, when i uploaded the modified ui_config.json file to the Global Profile under Tools > Guides > Folder Profiles / XML Editor Configuration, with the following changes to the repositoryFilters , { "t

Hi there. Is there any plan to offer certifications specifically for AEM Guides?

Hello All,I have a requirement to create News article page from Word document. Currently content authors manually authors the pages and we want to automate the process.If there is any better option available to automate the News article authoring process please do share.I am following the below AEM guides documentationhttps://experienceleague.adobe.com/en/docs/experience-manager-guides/using/install-guide/on-prem-ig/content-migration/migrate-content-non-ditaI have override the file "w2d_io_old.xml" and uploading the word doc. The workflow is showing in-progress for hours. And getting below error in the logs for file name "Sample_dita_file.docx".I have added two files with below content :file 1:Dita Map XMLThis is headingfile 2:Title: Dita Map XMLHeading 1: This is headingfor both I am getting below error.Anything I have missed to configure in my local which is causing the issue.22.04.2025 23:19:59.449 *INFO* [sling-threadpool-b6151423-8cb0-4f68-9ba3-0f77db9c4fc5-(apache-sling-job-

I've read the help on page templates and can see that we can hardcode a logo, other image, of background image into the design. I know that we can define text variables and display these on the page template. But what do we do if we have images that vary by publication, and we want to display one of those dynamic images on a location on the page? For example, a cover image of the product or additional symbols or logos specific to the publication. Is it possible to define an image variable that can be placed on the page layout design?  

Hi,In the documentation it mentions about JSON as one of the output presets, but I do not see JSON in the list of output presets. Is there any configuration needs to be modified to enable JSON output option? Also, is there an API to get the JSON response of the output?Thanks! 

I need to integrate the js file with index.html which get generate when pdf is html5 Can you share any refernce please

When i insert a custom snippet into Guides editor and tried to click the Undo button from Menu it is not working. But it is working for OOTB snippet and snippet having only one tag. Please let me know how to resolve the issue. <note></note>  ---> working  <section>    <title></title>   -----> not working</section>

I'm generating AEM pages using AEM Sites preset with custom component mapping with existing editable template. In the pages created links are not getting generated for glossary. For citation according to documentation it is supported only in Native PDF. Also for foot notes it is coming as a single line of text with no links.Currently I'm looking at using post processing workflows. Would like to know how we can process the pages created to create links for the same.

I have an requirement in AEM guides cloud when an asset uploads need to perform some update activity on metadata .Earlier we hv Dam Update asset Workflow and there we can add any custom workflow model to achieve this goal .Here in AEM cloud as this workflow not available hence without adding any custom workflow is there any OOTB preprocessing workflow to achieve this goal.

Join us to celebrate 10 years of  Adobe DITAWORLD Get ready for three days of inspiration and innovation with a stellar lineup of speakers from leading global brands. From customer success stories to groundbreaking product innovations, DITAWORLD 2025 has something for everyone.Why you can't miss out:Get inspired by real-world customer success storiesExplore Generative AI in technical communicationDiscover best practices in structured content managementRegister for freeCan't attend live? Register to receive the recording.

Hi, The below traversal query warn message is showing in the error.log file.  Created custom lucene index as suggested in the Oak utils Index generator and after reindexing, the query not picking the index as it is OOTB query.can someone please suggest on this?

Does anyone know of a way where we can either set up AEM or use external software to help us do the following A way to document when a page's content has been last changed (beyond just a typo fix). Perhaps the author could leave notes in a log what they changed.Send reminders to certain people we define at defined intervals telling them to review the content on a page. This would help us ensure it is still accurate and compliant. thanks

Let's assume I created some topics and corresponding map using AEM Guides.If I want an output file for example as AEM Sites, where I can change styles so its would render my content with a particular style that I defined.By default, If I generate an output as AEM Sites then the content is getting rendered as below.I wanted to add my own logo and make some other UI changes .Can someone help me with the same and guide me how can I do this?

Using Native PDF in Guides in Cloud. I have page numbering working fine in footer.Bookmap has:   Frontmatter, renders to 5 pages   Body, renders to 10 pages   Backmatter. renders to 5 pagesI restart page numbering after Frontmatter, so on page 6. Paging in footer shows page 6 of 20, 7 of 20, etc.Last page shows page 15 of 20. Obviously, I don't want that because it looks like there are 5 pages missing. Native PDF is not resetting the total page count when the page number is reset. Is this a bug or is there something I need to do? 

In the Assets > Properties view, DITA content doesn't preview like it does for images. Should something be displaying here? And if not, it would be nice to get that preview working for DITA content.In the Assets view, when you click on a DITA file to preview it, the content doesn't scroll down even though a scrollbar is present. Only the top section of the content displays. Is that scrollbar supposed to be working?

Registration is now open for Adobe Experience Manager Guides User Conference 2025, now a part of Adobe SUMMIT! Join us in Las Vegas March 16 – 17 to discover how digital-first businesses deliver exceptional experiences with technical documentation and knowledge content.Adobe Experience Manager Guides User Conference                                                                            March 16-17, 2025 | The Venetian Resort, Las VegasHere are the top three reasons why you should attend:Meet your tribe: Connect with the Adobe Experience Manager Guides user community, share your experiences, and hear their success stories.Exclusive preview of innovation: Get a first look at the latest innovations brewing in our labs.Unmatched networking and hospitality: Forge valuable connections with indust

Problem Statement You are using XML Documentation to author XML/DITA content and one of the publish output is AEM Sites.You want to use an existing AEM Sites template in order to use the pre-designed header/footer (branding, styles etc.) used on your marketing or end user portal (instead of out-of-the-box templates that comes with XML Documentation)For reference, lets take an example of we-retail website (AEM sample site) that has an already defined design. The left picture is an out-of-the-box template from XML Documentation, the right one is same content but using AEM's we-retail editable template.   This article will give details on how you can make use of existing AEM Sites templates to publish DITA/XML content   Some understanding towards the solution In this article: We will demonstrate use of we-retail template - an editable template (see additional resources for more details), so its assumed that your existing template is an editable template or you are aware o