Adobe Experience Manager Guides

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

Good afternoon!We use (AEM/Guides) Native PDF output and have our draft comments set to display in PDF output with special formatting.They had been working fine until we recently updated to 5.1. Now everything in Guides shows correctly (author, source, preview) but there are no Draft Comments in the output PDF. What could have caused this? Is there a default that reverted possibly?  Any help is appreciated!Thanks,Josh

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.

Hi, we are using AEM Guides Native PDF for publishing PDFs, and I wanted to check if others have encountered issues with table break behavior.Current behavior:Tables that begin and end on the same page render correctly. When a table spans across multiple pages: The portion on the next page starts directly with the table header. The table continues from where it was split, without any indication that it is continued. Expected behavior:Tables that begin and end on the same page should continue to work as expected. When a table spans multiple pages: The table portion on subsequent pages should display a label such as:"Table #: Table Title (continued)" This should be followed by the table header and the remaining table content. Example image:   

I have a requirement to add a custom column to the list view along with the other OOTB fields in Adobe Experience Manager (AEM) Cloud instance. Could anyone guide me on how to achieve this? I want to add a column with header Content-Type that will fetch the value from jcr:content/metadata/content-type.I could achieve this with the reorder.jsp file pointed here: https://experience-aem.blogspot.com/2019/10/aem-6520-aem-assets-add-custom-metadata-columns-in-assets-console-list-view.html but this does not work in AEM Cloud.Again, this URL also explains in another way : https://experience-aem.blogspot.com/2019/08/aem-6510-adding-custom-metadata-columns-in-list-view-of-assets-search-console.html but again this conflicts with OOTB behavior and breaks the search functionality in AEMaaCS.Any concrete solution that works on cloud?

I’m having an odd issue when receiving translations back from our provider.  Issue:When translations are accepted back into AEM from our translation provider, I'm seeing a variance in the metadata the assets end up with in the target folder.  It's mainly one field: "cq:TranslationSourcePath" (needed for my purposes) Project 1: Results show the cq:translationSourcePath (along with other metadata) on the target (de_de) assets “jcr:content” node. Project 2: missing translation metadata, Note it’s a different project, same target (de_de) note one of the only fields that gets copied to the target asset.Please Note: I'm not convinced this is a translation provider-related issue, as the data already exists in the "staging" area that AEM creates when initiating translations. Please see the screenshot below for the temporary location created for the translation (this is before the translation was sent back to AEM, i.e., before it was deleted as part of clean up):  Conclusion:Because the data ex

We are observing an issue in AEM Guides (Cloud Service) where the translation status does not revert after cancelling a translation job. As per Adobe documentation and earlier fixed issues, when a translation job is cancelled or deleted, the “In Progress” status should revert to the original state. However, in our environment, the status continues to remain “In Progress”. Observed Behavior: When sending a DITA topic/map for translation where the target language copy does not exist: A placeholder (empty) language copy is created. If the translation job is then cancelled: The placeholder file remains in the target language folder. The translation status of the asset still shows “In Progress”. The status does not revert even after some time or refresh. Expected Behavior: On cancellation of the translation job: Translation status should revert from “In Progress” to the original state. Placeholder language copies (if not translated) should ideally be cleaned up or

Hi Team,Can we deploy AEM Guide in AEM RDE environment Thanks

Has anyone else had any issue with their Condition Presets resetting back to nothing selected in the preset? Sometimes it happens in the source language and sometimes in one of the target languages, but not the others?When it happens in the source language, it had existed and the settings were saved, then a few months later it is zeroed out.

We have on premise AEM (6.5) author and publiser instance and during last 2-3 days our error.log file is full of following errors on publisher instanceOakState0001 errors09.04.2026 13:37:45.729 *ERROR* [55.32.21.101 [1775734665631] POST /bin/receive HTTP/1.1] com.day.cq.replication.impl.servlets.ReplicationServlet Error during replication: Repository error during node import: OakState0001: Unresolved conflicts in /content/some-page/jcr:contentcom.day.cq.replication.ReplicationException: Repository error during node import: OakState0001: Unresolved conflicts in /content/some-page/jcr:contentCaused by: javax.jcr.InvalidItemStateException: OakState0001: Unresolved conflicts in /content/some-page/jcr:contentCaused by: org.apache.jackrabbit.oak.api.CommitFailedException: OakState0001: Unresolved conflicts in /content/some-page/jcr:content Concurrency warning 09.04.2026 14:50:46.659 *WARN* [EventAdminAsyncThread #9] org.apache.jackrabbit.oak.jcr.delegate.SessionDelegate Attempted to perform

Missing keys/keyrefs used to generate specific “filler” content in the PDF: Key definition for "{keyrefName}" not found in the DITA map. With our upgrade to v5.1.1, this filler content no longer generates in the PDF and instead nothing generates to indicate any missing keys. Was this intentional? Is the only wayt to find missing keys to preview on-screen and look for red?

What are the best practices for managing graphics and ensuring the most recent copy uploaded to the repository is the current VERSION, not just a working copy?All documentation on version control I’ve found for Guides is specific to the DITA files, not graphics objects.When we upload/copy an updated graphic, the popup windows asks us if we want to create a version of the EXISTING working copy. It does not ask about creating a version for the correction we are uploading. It looks like whatever we last uploaded remains a working copy, not an actual version, which means graphics sent out for translation may not be the most recent and correction file.Does this mean any time we upload a corrected graphic, we have to drag/drop twice. Once to upload and force the system to create a new version of the existing working copy and the new graphic become the existing working copy. Then a second time to force that correction to be the newest version?I’m seeing graphics that I know have been changed/

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

We have an instance of AEM 6.5.12. with Guides 4.6 UUID running on a server and we want another instance of the exact same thing on another server that we will use as our “development server.” This is not an upgrade. We want the 2 instances to be identical.On our new server I have installed the exact same AEM 6.5 with the same service pack and same 4.6 release guides.  All we need is the repository from the first instance. I cannot use package manager to do this because we must preserve the version history of all of our DITA topics.  From the documentation I’ve read it seems the best way to do this is with ther CRX2OAK tool.I’m not experienced with migration and would appreciate any steps or advice you might have. First, is the CRX2OAK tool the  best way to accomplish this? How do I get one repository to connect with another? Should the crx-quickstart folder from the target server be on the same server as our first AEM installation?  If so, what is the best way to move the crx-quicksta

Hello,We’re in the process of setting up our AEM Guides instance and have that link to our Workfront projects. I’ve noticed that the Workfront tasks list of AEM Guides has a limited number of columns. It would be helpful to our users to see the task percent complete, start dates, and predecessors on this view. Is it possible to add more columns to this view either through the native connector between the two or through Fusion?

I am searching for the question/answer series titled “Translations - Latest source language version of the map was not sent out”. I’m not seeing it in the AEM Guides group and it wasn’t listed under my account within the list of questions I had posted. Were some posts lost in the move to this new URL/interface?

Hi All, I am new to AEM Guides and tried my hand at importing an existing DITA project from https://github.com/DITAWriter/pilot_training_mitchell_bomberThis is a DITA-fied version of the Pilot Training Manual for the Mitchell Bomber B-25 I installed the package - com.adobe.fmdita.uuid-6.5-4.6.1.5886.zipI was unable to install the package com.adobe.fmdita.uuid-6.5-SP due to dependency com.adobe.fmdita:com.adobe.fmdita.uuid-6.5:5.0.0.211I created a folder in my DAM project and dumped .dita files from the above repo in it. When I tried to access the same in Guides editor window I get the below -  If I try to go into “Preview” mode I get the “Loading preview...” overlay which doesn’t go away -   Can anyone help point what am I doing wrong here? Thanks,Nagesh

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

Hi,I am using AEM cloud and we have Guides, when we select an asset (dita), we are able to see a Open in Framemaker button which when clicked opens the asset in FM. Do we have anything as such for Adobe illustrator, if Yes how do we enable it?If No, how to we build one which works just like the Open in Framemaker button??  This is how to enable the Open in Framemaker button:ThanksSandeep

I’m facing an issue with AEM Guides on AEM as a Cloud Service while generating Sites output from a DITAMap that references Markdown topics using this documentation: https://experienceleague.adobe.com/en/docs/experience-manager-guides/using/knowledge-base/kb-articles/authoring/webeditor/markdown-in-dita-and-aem-guidesWhat I’m seeing: The DITAMap → Site generation runs Site pages do get created Page properties (sourcePath, UUIDs, map references, etc.) are all set correctly along with the hierarchy of nodes. However, the content is missing - the “injected-container” on the page is empty This preset works for normal dita topics. Error in logs:Markdown resource cannot be read as an XML Document org.xml.sax.SAXException This happens during the NodeJS-based publishing workflow, specifically while Guides is extracting dependencies / DTD rules. From the stack trace, it looks like the Markdown file is being attempted to be read as an XML document.Pages are created but the Markdown conten

I am trying to migrate existing unstructured FrameMaker documents (.fm and .book) to DITA following the official documentation here: Migrate unstructured FrameMaker documentsHowever, I am unable to proceed because the Map to DITA (or Convert to DITA) button is missing from the Assets toolbar when I select my .fm file. When I open the file, I only see options to generate PDF, HTML5, and EPUB (as shown in the attached screenshot), but no option for DITA migration.Steps to Reproduce: Upload an unstructured FrameMaker file (.fm) to an AEM Assets folder. Select the file. Look at the top toolbar and the Output Presets panel. Actual Result: The Map to DITA button is not visible. Only standard Asset options and Generate (PDF/HTML5/EPUB) are visible. Expected Result: The Map to DITA button should appear to initiate the migration workflow using the .sts file. Environment: Adobe Experience Manager (2025.11.23385.20251113T172403Z) aem-guides (2025.10.0.278)  

I'm trying to install Adobe Experience Manager 6.5 on Windows Server 2022 on command with the following command C:\AEM\Author>java -jar AEM_6.5_Quickstart.jar -r author -p4502However the installation keeps getting stuck on "Press CTRL -C to shutdown the Quickstart Server:Loading quickstart properties: defaultLoading quickstart properties: instanceLow-memory action set to forkUsing 64bit VM settings, min.heap=1024MB, min permgen=256MB, default fork arguments=[-Xmx1024m, -XX:MaxPermSize=256m]The JVM reports a heap size of 2048 MB, meets our expectation of 1024 MB +/- 20Setting properties from filename 'C:/AEM/Author/AEM_6.5_Quickstart.jar'Setting 'sling.run.modes' to 'author' from command line.Verbose option not active, closing stdin and redirecting stdout and stderrRedirecting stdout to C:\AEM\Author\crx-quickstart\logs\stdout.logRedirecting stderr to C:\AEM\Author\crx-quickstart\logs\stderr.logPress CTRL-C to shutdown the Quickstart server...Java version installed is 21.0.9.Any idea

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" <--&

We need to update the DITA-OT that is included with AEM Guides to get a newer version of FOP. I have managed to migrate our custom PDF plugins to the new OT (4.3.4), but the AEM Sites output is not working. The files are processed properly by the DITA-OT, but are not getting handed over to Guides to create the site. I notice differences in the log output when publishing with different DITA-OT versions. I need a few hints on how to get the job-helper.xsl working in the newer DITA-OT. Working DITA-OT:copy-flag-check:copy-flag:[job-helper] Processing /opt/aem/launcher/profiles/ditamaps/ditamap15676432144876924428/temp/temp20251105141348914/.job.xml to /opt/aem/launcher/profiles/ditamaps/ditamap15676432144876924428/temp/temp20251105141348914/flagimage.list[job-helper] Loading stylesheet /opt/aem/launcher/profiles/ditaot--3922c171-076c-7dd5-4b4b-9b4f895be1bd/DITA-OT/plugins/org.dita.base/xsl/job-helper.xsl New DITA-OT:copy-flag-check: copy-flag: Thanks,-Huntley

I have created a custom property and added it to the file properties (Metadata Schema Form Editor)The custom property list was added to /libs/fmdita/config/metadataListThis made the list available in the Map Console > Advanced > File Properties dropdown.I selected each of the property from the dropdown and generated an output.However, this selection does not seem to have any impact on the metadata that is available in the output. The list is simply not picked up! Can you help me understand the behaviour? And also, help me with the any configuration that needs to be set to get the custom metadata tags propagated to the output?