How to Add , Remove and Manage tags in your DITA content

Tags come useful to categorize your content. If content is properly tagged, then it can help you in locating exact topics in your ditamap and end user finds the appropriate content more quickly on your published output

NOTE: Following article is for AEM Guides Build 4.2 (on-prem) /Feb 2023 (cloud version ) or higher versions

Create Tags

Tagging is native AEM feature and your AEM administrator can help in initial creation and configuration of these tags.

Add, Remove, and Manage tags in your DITA content

Any tags created in AEM cq: tags can be added, removed, and managed for your DITA contents

There are various ways to add tags into your DITA content but this article will concentrate to AEM Guides web-editor UI.

Steps:

  1. Go to repository view in Guides UI
  2. Double-click ditamap and open in map view
  3. Go to Manage Tab
  4. In Manage tab , Go to Metadata option
  5. All your direct and indirect ditamap files list loads here.
  6. Select one or more files and click the ‘manage’ icon. Here you can add tags to selected files.
    You can also remove existing tags which are common in selected files.

Manage Tags in DITA

Troubleshooting and FAQ

List in manage->metadata is empty or incomplete

If list is empty or incomplete then you may need to run the indexing on your ditamap, You can refer Upgrade instructions(Index your content)

Custom metadata is not coming up in list

Only Tags present in cq:tags can be managed from here and custom metadata is not supported

Other helpful resources

Contact your respective CSM for any other queries

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178