Skip to main content


New ACS AEM Commons Contribution: Tag Reports

Tags (1)

Tags are one of the most powerful features of Adobe Experience Manager (AEM), using tags content authors and asset managers can create secondary taxonomy associations between content.
The challenge with many AEM installations is that tag taxonomies tend to grow over time, especially if ad-hoc tags are enabled. AEM’s Tag Administration console allows Taxonomy Managers to delete, merge and move tags, however, before making changes, you really should understand how a tag is used. You can view references, but this is only available at the individual tag level.
Recently, I built a new Managed Controlled Process to create a report of the tags and their references.

Starting the Tag Report Managed Controlled Process

Using Tag Reports

This report allows for configuring the following settings:

  • Tag Path – the path under which to search for tags. This will work for both /etc/tags and /content/cq:tags
  • Root Search Path – the path under which to search for references
  • Include References – whether or not to include the actual reference values in the report
  • Reference Method – this option allows you to select between using TagManager.find  which is faster, but will only search for cq:tags attributes under cq:Taggable nodes or a deeper search which does a full text search against the tag ID

Starting the report will execute the process in the background. While the report executes, you can open a summary of the report execution.

Tag Report Summary

Once the process completes, you can view a report with all of the tags under the path including:

  • Reference Count – the number of times the tag is referenced under the specified content tree
  • References – the list of references if Include References is checked
  • Status – the status of attempting to report the tag, generally should be Success
  • Tag Id – the AEM Tag ID for the tag
  • Tag Title – the tag title in English

The report can be viewed online or downloaded to an Excel file.

View the Tag Report

Getting Tag Reports

The Tag Report MCP will be available in the upcoming release of ACS AEM Commons. Check back soon to see when it’s released!

Thoughts on “New ACS AEM Commons Contribution: Tag Reports”

  1. Hi Dan, this works really well and is very helpful. Do you know if it is possible to create a similar report, but where the tags are grouped by the asset path? (n-number of tag paths to one asset path) Thanks!

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Dan Klco, Adobe Digital Marketing Technical Director

Dan is a certified Adobe Digital Marketing Technologist, Architect, and Advisor, having led multiple successful digital marketing programs on the Adobe Experience Cloud. He's passionate about solving complex problems and building innovative digital marketing solutions. Dan is a PMC Member of the Apache Sling project, frequent Adobe Beta participant and committer to ACS AEM Commons, allowing a unique insight into the cutting edge of the Adobe Experience Cloud platform.

More from this Author

Follow Us