Administering Tags administering-tags

Tags are a quick and easy method of classifying content within a website. They can be thought of as keywords or labels (metadata) that allow content to be more quickly found as the result of a search.

In Adobe Experience Manager (AEM), a tag can be a property of

In addition to pages and assets, tags are used for AEM Communities features

Tag Features tag-features

Some of the features of tags within AEM include:

  • Tags can be grouped into various namespaces. Such hierarchies allow taxonomies to be built. These taxonomies are global throughout AEM.

  • The main restriction for newly created tags is they must be unique within a specific namespace.

  • A tag’s title should not include tag path separation chars (nor will they be displayed if present)

    • colon : - delimits the namespace tag
    • forward slash / - delimits sub-tags
  • Tags can be applied by authors and site visitors. Irrespective of their creator, all forms of tags are made available for selection, both when assigning to a page, or when searching.

  • Tags can be created and their taxonomy modified by members of the “tag-administrators” group and members who have modification rights to /content/cq:tags.

    • A tag that contains child tags is referred to as a container tag
    • A tag that is not a container tag is referred to as a leaf tag
    • A tag namespace is either a leaf tag or container tag
  • Tags are used by the Search component to facilitate finding content.

  • Tags are used by the Teaser component, which monitors a user’s tag cloud to provide targeted content.

  • If tagging is an important aspect of your content

    • make sure to package tags with the pages that use them
    • make sure tag permissions enable read access

Tagging Console tagging-console

The Tagging console is used to create and manage tags and their taxonomies. One goal is to avoid having many similar tags relating to basically the same thing : for example, page and pages or footwear and shoes.

Tags are managed by grouping into namespaces, reviewing usage of exiting tags before creating new ones, and re-organizing without disconnecting the tag from currently referenced content.

To access the Tagging console :

  • on author

  • sign in with administrative privileges

  • from global navigation

    • select Tools
    • select General
    • select Tagging


Creating a Namespace creating-a-namespace

To create a namespace, select the Create Namespace icon.

The namespace is itself a tag, and does not to contain any sub-tags. However, to continue creating a taxonomy, create sub-tags, which in turn may be either leaf tags or container tags.

chlimage_1-183 creating_tags_andnamespaces

  • Title
    (required) A display title for the namespace.

  • Name
    (optional) A name for the namespace. If not specified, a valid node name is created from the Title. See TagID.

  • Description
    (optional) A description of the namespace.

Once the required information is entered

  • select Create

Operations on Tags operations-on-tags

Selecting a namespace or other tag makes available the following operations:


When the browser window is not wide enough to display all icons, then the right-most icons are grouped together under a ... More icon, which will display a drop-down list of the hidden operation icons when selected.


Selecting a Namespace Tag selecting-a-namespace-tag

When first selected, if the namespace does not contain any tags, then the properties are displayed to the right, else the child tags are displayed. Each tag selected will display either the tags it contains or its properties if it does not have child tags.

To select the tag for operations, and to multi-select, only select the icon next to the title. Selecting the title will only display properties or open the tag to display its contents.

chlimage_1-186 chlimage_1-187

Viewing Tag Properties viewing-tag-properties


When a namespace or other tag is selected, selecting the View Properties icon results in the display of information as to the name, time of last edit, and number of references. If published, the time it was last published and the id of the publisher are shown. This information will appear in a column to the left of the tag columns.


Showing Tag References showing-tag-references


When a namespace or other tag is selected, selecting the References icon will identify the content to which the tag has been applied.

The initial display is a count of tags applied.


By selecting the arrow to the right of the count, the reference names are listed.

The path to the reference is displayed as a tool tip when hovering over a reference.


Creating Tags creating-tags


When a namespace or other tag is selected (by selecting the icon next to the title), a child tag may be created for the current tag by selecting the Create Tag icon.


  • Title
    *(required) *A display title for the tag.

  • Name
    *(optional) *A name for the tag. If not specified, a valid node name is created from the Title. See TagID.

  • Description
    *(optional) *A description of the tag.

Once the required information is entered

  • select Create

Editing Tags editing-tags


When a namespace or other tag is selected, it is possible to alter the Title, Description, and provide localizations of the Title by selecting the **Edit**icon.

After edits are made, select Save.

For details about adding language translations, see the section on Managing Tags in Different Languages.


Moving Tags moving-tags


When a namespace or other tag is selected, selecting the Move icon will allow Tags Administrators and Developers to clean up the taxonomy by moving the tag to a new location or renaming it. When the selected tag is a container tag, moving the tag will move all child tags as well.

It is recommended that Authors only be allowed to edit the tag’s title, not to move or rename tags.


  • Path
    (readonly) The current path to the selected tag.

  • Move to
    Browse to the new path under which to move the tag.

  • Rename to
    Initially displays the current nameof the tag. A new namemay be entered.

  • select Save

Merging Tags merging-tags


Merging tags can be used when a taxonomy has duplicates. When tag A is merged into tag B, all the pages tagged with tag A will be tagged with tag B and tag A is no longer available to authors.

When a namespace or other tag is selected, selecting the Merge icon opens a panel where the path to merge into may be selected.


  • Path
    (readonly) The path of the tag selected to be merged into another tag.

  • Merge into
    Browse to select the path of the tag to merge into.

After the merge, the Path originally selected will (virtually) no longer exist.
When a referenced tag is moved or merged, the tag is not physically deleted such that it is possible to maintain references.

Publishing Tags publishing-tags


When a namespace or other tag is selected, selecting the Publish icon to activate the tag in the publish environment. Similar to page content, only the selected tag is published, regardless of whether it is a container tag or not.

To publish a taxonomy (a namespace and sub-tags), the best practice is to create a package of the namespace (see Taxonomy Root Node). Be sure to apply permissions to the namespace before creating the package.

Unpublishing Tags unpublishing-tags


When a namespace or other tag is selected, selecting the Unpublish icon will deactivate the tag in the author environment and remove it from the publish environment. Similar to the Deleteoperation, if the selected tag is a container tag, all of its child tags will be deactivated in the author environment and removed from the publish environment.

Deleting Tags deleting-tags


When a namespace or other tag is selected, selecting the Delete icon will permanently remove the tag from the author environment. If the tag was published, it is also removed from the publish environment. If the selected tag is a container tag, all of its child tags will be removed as well.

Setting Tag Permissions setting-tag-permissions

Tag permissions are ‘secure (by default)’; a best practice for the publish environment that requires read permission to be explicitly allowed for tags. Bascially, this is done by creating a package of the Tag Namespace after permissions have been set on author, and installing the package on all publish instances.

  • on author instance

    • sign in with administrative privileges

    • access the Security Console,

      • for example, browse to http://localhost:4502/useradmin
    • in the left pane, select the group (or user) for which read permission is to be granted

    • in the right pane, locate the **Path **to the Tag Namespace

      • for example, /content/cq:tags/mycommunity
    • select the checkboxin the Read column

    • select Save


  • ensure all publish instances have same permissions

    • one approach is to create a package of the namespace on author

      • on Advanced tab, for AC Handling select Overwrite
    • replicate the package

      • choose Replicate from package manager

Managing Tags in Different Languages managing-tags-in-different-languages

The titleproperty of a tag may be translated into multiple languages. Once translated, the appropriate tag titlemay be displayed according to the user language or to the page language.

Defining Tag Titles in Multiple Languages defining-tag-titles-in-multiple-languages

The following describes how to translate the titleof the tag Animals from English into German and French.

Start by selecting the tag under the Stock Photography namespace and selecting the **Edit**icon (see Editing Tags section).

The Edit Tag panel presents the ability to choose languages into which the tag title is to be localized.

As each language is selected, a text entry box appears into which the translated title may be entered.

Once all translations are entered, select Save to exit edit mode.


In general, the language chosen for the tag is taken from the page language, when available. When the tag widget is used in other cases (for example, in forms or in dialog boxes), the tag language depends on the context.

Instead of using the page language setting, the Tagging console uses the user language setting. In the Tagging console, for the ‘Animals’ tag, ‘Animaux’ would be displayed for a user who sets the language to French in their user properties.

To add a new language to the dialog, see Adding a New Language to the Edit Tag Dialog.

The tag cloud and the meta keywords in the standard page component use the localized tag titlesbased on the page language, if available.

Resources resources