Adobe Experience Manager Guides

We have an AEM page (product.html) that is quite heavy due to a large number of authored components. As a result, only part of the components load during authoring, which affects usability.To work around this, we increased the request size in the main Sling servlet from the default value of 1000 to 2000. This resolved the component loading issue during authoring but its not performance oriented . This page also takes significantly longer to load via the dispatcher URL. we to make it better .I’m looking for best practices or architectural approaches to make the authoring experience smoother and more user-friendly, while also ensuring optimal performance on the dispatcher. Any suggestions to address both concerns would be greatly appreciated.

I am trying to send over a topic for review to the designated users and I can successfully do that. But the issue is once the reviewer has highlighted any text or may have added comments, it is not visible to me. What exactly am I missing?Also, I would like the reviewer to change the document state to "reviewed"/"approved"/"rejected" (based on the options available) - how to do that? 

When I run the following Junit testing code: import com.adobe.aemfd.docmanager.Document;import org.junit.jupiter.api.BeforeEach;import org.junit.jupiter.api.Test;import org.w3c.dom.Element;import javax.xml.parsers.DocumentBuilder;import javax.xml.parsers.DocumentBuilderFactory;import java.io.ByteArrayInputStream;import java.io.InputStream;import java.nio.charset.StandardCharsets;import static org.junit.jupiter.api.Assertions.*;class TableOfContentTest { private Document pdfDoc; private ProcessInputXML processInputXML; private TableOfContent tableOfContent; @BeforeEach void setUp() throws Exception { // Load valid PDF content from a file or resource InputStream pdfInputStream = getClass().getResourceAsStream("/logo.pdf"); // Ensure this file exists in resources pdfDoc = new Document(pdfInputStream); // Initialize the ProcessInputXML object org.w3c.dom.Document inputXML = DocumentBuilderFactory.newInstance().newDocumentBuilder().newD

@divrajsingh could you assist me with the following requirement? I want to align the published content with our organization’s branding guidelines, this includes applying custom CSS, fonts, colors, logos, and possibly modifying the layout or templates used during the publishing process. 

What is the latest aem-service-pkg-6.5 version and where can we update. We are using aem-service-pkg-6.5.21.

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

Hello AEM Guides Community,I’m new to AEM Guides and working on creating an aggregated document that includes multiple languages in a single PDF output. My main document contains a front page (cover) and then multiple languages each with it's own translated TOC.I want the PDF to show:The front page first,Then for each language submap, a Table of Contents for just that submap,Followed by the actual content of that language submap.What is the recommended way to structure the map and customize the native PDF template to achieve this aggregated, multilingual document with per-submap TOCs?Are there best practices or example templates you can share?Thanks so much for your help!

When searching in AEM Guides (on-prem, v4.6, UUID) for a specific file name GUID, the result returns every instance that GUID is conref-ed to in addition to the master file we are searching for. Is there a way to separate the search results into a list of file names/titles using the search phrase AND then into a list of files where the search phrase appears within the content? For example, when searching within our repository for file name GUID-B2A00D10-2503-48FA-928C-8D84F08CBA0F, 400+ results appear because this was one of our master files that many other topics conref to. The existing filters do not allow for a separation of file name/GUID vs content within a file. Is that possibly a future feature? Can the filters be customized? (I saw an answer from 7/2/25 that mentioned filters may be customizable in version 5.1 or whatever the Q3 2025 release is going to be.)

I'm working on a JavaScript project in VS Code using the AEM Guides Extension framework. In the codebase, there's frequent usage of tcx, but VS Code keeps showing errors like "tcx is not defined" and doesn't provide any IntelliSense for it.How can I configure my project so that:VS Code recognizes tcx as a global object (or however it's defined in the framework)?IntelliSense works properly for tcx and its properties/methods?Any tips on setting up type definitions or project configuration to fix this would be greatly appreciated! 

We are not seeing any way to enter notes about new versions of images in the repository. Is there no way to track version changes to images and other non-DITA assets?

AEM Guide when users select a element in the current open DITA file below a breadcrumb shows the path of the selected elementmy question how can i get the xpath of the selected element  or even better how to get the active (selected) element in the tcx.activeEditor.xmlDocI need to know which xml element is selected in the editor and bind that to the element in the tcx.activeEditor.xmlDocBo, BJ Dita

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-

We are using Guides Version: 5.0.0.211 in AEM 6.5 with service pack 21. We want to add some custom filters in the guides editor. We followed these two documents.https://experienceleague.adobe.com/en/docs/experience-manager-guides/using/install-guide/on-prem-ig/web-editor-configs/conf-custom-file-filtershttps://experienceleague.adobe.com/en/docs/experience-manager-guides/using/knowledge-base/expert-session/metadata-define-manage-utilize-may2024We added filters in the Folder Profile ui_config.json file. First, added the filters in the "browseFilters" section, and it's not coming in the editor. Then added filters in "repositoryFilters" section. Now the filters are appearing in the Advanced Filter popup like below However, when applying these custom filters, the search results are not coming based on that. When inspecting the network call on clicking Apply, in the request payload, only the OOTB filters are going and not our custom filters. Also, we notice something called wi

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?  

DITA Specializations in Native PDF Publishing (Topics Disappear in PDF) We have one DITA specialization that appears to be properly configured in AEM Guides. I can insert it and use it in the XML Editor in topics and concepts. In previous AEM Guides versions, this specialization appeared in PDF outputs, but that may have been using FMPS before Native PDF Publishing was released. I don't recall if I ever tested it in the earlier versions of Native PDF Publishing. We abandoned this specialization because there was no easy way to format it for the AEM Sites output. However, we'd like to return to using this specialization (which is based on the PARML element) since DITA is designed for easy customization and future releases will make it easier to format the AEM Sites outputs. The specialization appears in the default DITA-OT PDF output. It is unformatted (expected behavior) because there is no easy to way format the DITA-OT files, but it does appear. Currently (AEM Gui

Hi community, A colleague of mine recently returned from the Adobe conference and shared that they spoke with several users who advocated against using content reuse. I attended the conference the year prior, and my experience was quite the opposite. I met many users who were using content reuse effectively and shared great success stories. So I wanted to bring the question here: Are there other organizations (especially in highly regulated or complex industries) effectively using content reuse in Adobe Experience Manager? Thanks in advance for your insights!

Hello - I am new to AEM Guides and I have encountered an error when publishing with conditions - Installed AEM Guides 4.4.0.40- Created a Map- Imported the dita file WritingWell.dita from https://experienceleague.adobe.com/en/docs/experience-manager-guides-learn/videos/output-generation/publishing-with-conditions and followed the instructions in applying conditions.  Encountered error: 

I have been struggling to identify an answer to this question via documentation or previous posts.  Our users are finding the behavior of this search box in Guides confusing / unhelpful in comparison to, say, the Assets search.   Is it possible to change/configure what is searched via a query within this search box specifically?  From testing, searches performed within this search box do not cover the range of properties or within the content that the Assets search does. Near as I can tell, this search is more limited to terms present in file names and/or titles.    However, users do not want to leave Guides to find what they need and then have to navigate back into Guides to work on it.  Ideally for our users, they would be able to search here and get hits within the DITA map/topic content. Note that I am familiar with the instructions at https://experienceleague.adobe.com/en/docs/experience-manager-guides/using/install-guide

Hello All,I’m facing an issue when attempting to send Topics created in AEM Guide for translation. Here’s a breakdown of the situation and the errors encountered, along with some observations: Issue Summary:When trying to translate Topics created directly in AEM Guide, the workflow fails, producing errors related to missing nodes and XML processing. Specifically, the Elements node is absent in the jcr:content of these Topics, which might be impacting the translation workflow.Error Details:During the translation process, these are some of the errors I’m seeing:1. Error Loading Destination Language:com.day.cq.dam.commons.util.DamLanguageUtil Failed to load destination language from payload2. XML Processing Error:com.adobe.fmdita.exception.ApplicationException: Failed to process XMLNode with path /content/dam/projects/translation_output/.../Training.dita/jcr:content/elements does not exist.This `PathNotFoundException` suggests that the translation job is looking for an `elements` nod

Hello all,We have httpd.conf file added to the dispatcher codebase base and the changes are not updating through code pipeline.  All the files are updated through code pipeline except httpd.conf file. Please find below file updated dates, also the user rights also same as other files.  Please suggest if this required any additional configurations.  

One of our customer requirements is to construct a ‘Contact Information’ block of addresses on the back page.They don’t want to hardcode this in a table in a topic. We'll have a template with an empty, single row, table and we'd dynamically expand the table based on the required number of address blocks.They want to store each address block in a bookmeta/authorinformation/organizationinfo block and then to format this content and inject it into a cell per address.The number of address organizationinfo blocks will vary by publication, and the information in an organizationinfo block will vary.Because of this variability, using the provided method to create variables from this metadata does not seem to be ideal or efficient. Since the variables are text-only, if we create a variable from the organizationinfo element as a whole we lose all the internal structure.We were hoping for an HTML structure that retained the internal structure and provided us with something we can manipulate in Ja

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>

Guides allows the ability to view the differences between versions of the same topic. In this view there are red and green bars indicating additions and deletions. They are displayed side by side in the left margin in the location the change was made.In Native PDF you can do this too, and there are OOTB templates with styles to display the bars. However, the green bar, unlike in the Guides editor, always overwrites the red bar. The only styles that I see for this bar are as follows:.inserted-change-bar { -ro-change-bar-color: #2ECC40; } .deleted-change-bar { -ro-change-bar-color: #FF6961; }I tried to add a margin to one of them but it did not work. How can I offset one of the bars so that they both display when a line has both an addition and a deletion?