Expand my Community achievements bar.

Broken file references in AEM pages


Level 1


when I try to use any internal references or documents available inside AEM DAM to topics it works in the preview mode and when publishing the same content to AEM site pages It is rendered as plain texts instead of reference links in the pages. 
workaround : publish the documents to publish server and use the complete link. 

This is observed on guides version 4.0.3 and aem 6.5.11

kindly provide a fix for this. 

1 Reply


Level 6

Please follow the below steps to add the non-dita file references. 


1. Overlay the elementmapping.xml file from /libs/fmdita/config/elementmapping.xml to your custom folder under apps.


2. Add the following code to the xml file (Eg. PDF format)




    <class>- topic/xref</class>







      <attribute from="href" to="link" ispath="true" rel="SOURCE" />

      <attribute from="format" to="format" />

      <attribute from="scope" to="scope" />




3. Update the Override Element Mapping setting in the com.adobe.fmdita.config.ConfigManager configuration and save it.



4. Add the format attribute for the file reference.