DocumentationExperience Cloud KCS

Unable to add tags to PDF documents after an AEM LTS upgrade

Last update: October 2, 2026

This article explains how to resolve an issue in Adobe Experience Manager (AEM) where users are unable to add tags to PDF documents after a Long-Term Support (LTS) upgrade. The issue occurs when the PDF tagging configuration is not updated correctly following the upgrade, preventing tags from being assigned to PDF assets. To resolve the issue, update the PDF tagging configuration and validate the tagging workflow.

Description description

Environment

  • Adobe Experience Manager (AEM) authoring environment
  • Recent Long-Term Support (LTS) upgrade

Issue/Symptoms

  • Users are unable to add tags to PDF documents.
  • The tagging functionality is unavailable or fails when attempting to add tags to PDFs.

Steps to reproduce:

  1. Upload a PDF document to AEM.
  2. Navigate to the provider tab.
  3. Attempt to add tags to the PDF.
  4. The tagging functionality is unavailable or fails.

Root cause

The tagging configuration for PDF documents may not be configured correctly after the LTS upgrade, preventing tags from being added.

Resolution resolution

Follow the steps below to resolve the issue:

  1. Review the tagging configuration for PDF documents in the AEM authoring environment.

  2. Update the configuration as follows:

    • Add the rootPath property and set its value to match the current tagsPath value.
    • Set the multiple property to true to allow multiple tags to be added to a PDF.

  3. Save the configuration changes.

  4. Test the updated configuration by uploading a PDF document and verifying that tags can be added successfully.

  5. Confirm with the content teams that tagging functionality is restored for all relevant workflows.

  6. If the configuration is managed through code deployment, include the configuration change in the codebase before the next release to prevent the issue from recurring.

  7. Verify the resolution by confirming that tags can be added successfully to PDF documents.

recommendation-more-help
experience-cloud-kcs-help-kbarticles