Bulk tagging of DITA content

Last update: January 20, 2025

CREATED FOR:

  • User

Tags allow you to group or classify content within your content repository and also in the published output. If you have applied tags on your content, you can easily find related topics within a DITA map that can help you to authoring content. With the published output, end users will be able to locate the right content faster with proper tags in place.

Adobe Experience Manager Guides allows you to tag DITA content in a few steps. You can use the bulk tagging feature to apply multiple tags on multiple topics, a DITA map, or on a sub-map. Or, you can also apply tags on an individual topic. Tagging is the native feature in Adobe Experience Manager, you can find more details about creating and managing tags in the Administering Tags section in Adobe Experience Manager documentation.

By default, Experience Manager Guides does not grant read access to any user on the folder where all tags in the Adobe Experience Manager repository are stored. To use tags defined in the Adobe Experience Manager repository, you must ask your system administrator to grant access on the folder where the tags are stored.

Apply bulk tags

Use the bulk tagging feature to apply multiple tags at once. Perform the following steps to apply tags to your topics in a DITA map:

  1. In the Assets UI, navigate and select the DITA map file.

    The DITA map console appears showing the list of Output Presets available to generate output.

  2. Select Topics.

    A list of topics available in the DITA map are displayed. The UUIDs of topics’ is shown below the topic title.

  3. Select the topics or sub-map on which you want to apply tags.

    NOTE
    The above screenshot shows a sub-map selected and expanded. On selecting the sub-map, all the topics under the sub-map are also selected.

  4. Select Apply Tags.

    The Select Tags dialog appears.

  5. Select one or more tags that you want to apply on the selected topics.

  6. Confirm your selection.

    The selected tags are applied on the topics and shown next to the topic title.

    NOTE
    After adding tags to your topics, if you move or delete a topic, then the tags for those topics are also removed. However, that topic remains in the map until you remove it.

Apply tags on an individual topic

Perform the following steps to apply tags to an individual topic:

  1. In the Assets UI, navigate to and select the topic file on which you want to apply tags.

  2. In the toolbar, select Properties.

    The topic’s properties page appears.

  3. In the Basic tab, select the Browse icon next the Tags field.

  4. Select one or more tags that you want to apply on the selected topic.

  5. Confirm your selection.

  6. Select Apply Tags.

    The selected tags are applied on the topic and shown in the Tags field.

  7. Select Save & Close.

Remove tags

As per your business needs, you can change the tagging information for any DITA topic. You can easily remove all tags at once or remove only those tags that are no valid on the topic.

Perform the following steps to remove all tags from one or more topics:

  1. In the Assets UI, navigate to and select the DITA map file.

    The DITA map console appears showing the list of Output Presets available to generate output.

  2. Select Topics.

    A list of topics available in the DITA map are displayed.

  3. Select the topics from which you want to remove tags.

  4. Select Remove Tags.

    NOTE
    If the Delete Tags icon is not visible, ensure that you have not enabled the Hide Tags feature.

  5. On the Confirm Delete dialog, select OK to remove tags from the selected topics.