Documentation

Hyperlinks missing in Word to PDF conversion using PDFG and PageOverlay in AEM

Last update: Tue May 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

When converting Word documents to PDF using the AEM PDFG service with the PageOverlay option of the Assembler Service, hyperlinks do not appear in the resulting PDF. To fix this, set the embedFormsAndAnnots parameter to true in the configuration settings.

Description description

Environment

Adobe Experience Manager (AEM) On-Premise, v6.5 MS Office Professional Plus 2019

Issue/Symptoms

  • Hyperlinks embedded in a Word document do not appear in the resulting PDF file after conversion.
  • The embedFormsAndAnnots parameter, responsible for adding annotations (including hyperlinks, comments, highlights, sticky notes, shapes, hyperlinks and other markup elements) in PDF documents, is set tofalse by default, causing annotations to be missing in the output document.

Resolution resolution

To retain hyperlinks during Word-to-PDF conversion, follow these steps:

  1. Adjust the Assembler service task configuration by setting the embedFormsAndAnnots parameter to true to preserve forms and annotations, including hyperlinks.

  2. Define this parameter within your configuration as follows:

    code language-none 
    {      "options": {        "embedFormsAndAnnots": true      },      "sourceDocuments": [         "document1.pdf",        "document2.pdf"      ] ,      "resultDocument": "assembledDocument.pdf"    }

  3. Test your setup to ensure hyperlinks appear correctly in the generated PDF file after applying this change.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f