Administering Tags

Tags are a quick and easy method of classifying content within your website. In technical terms, a tag is a piece of metadata assigned to a content node within CQ (usually a page). You can also think of them as keywords or labels that you attach to a page to help you find it again.

  • Within CQ, tags can be grouped into various namespaces. Such hierarchies allow taxonomies to be built. These taxonomies are transparent across CQ WCM, CQ DAM and CQ Social Collaboration.
  • There are no restrictions on the tags you can create - though they must be unique within a specific namespace.
  • Tags can be created by either the page creator, or viewer. Irrespective of their creator, all forms of tags are made available for selection, both when assigning to a page, or when searching.
  • To be able to modify the taxonomy, a user must be a member of the "tag-administrators" group (or have modification rights to /etc/tags). Assigning existing tags to content nodes does not require tag-administration rights. It reflects the distinction between authors using tags and librarians managing the taxonomy.
  • Tags are also 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.

For information about authoring and using tags, see Using Tags.

For information about extending tags and the API, see Tagging for Developers.

Top Ten Reasons to Use Tagging

  1. Tagging makes your life easier by giving you a straightforward way to organize content without too much thought.
  2. Tags can be controlled. The flexibility and simplicity of tags does not interfere with anything - you have still full control over all your content. Apply permissions to tags and/or namespaces to control who can create tags on your content or use your existing tags.
  3. You can never have too many tags. Though if you have a lot, you can create namespaces to sort and organize your tags. With namespaces you can create categories of tags to make sure that tags that belong together are grouped together.
  4. Tags are powerful organizers. With the ability to create tags and sub-tags it becomes possible to express entire taxonomic systems, covering terms, subterms and their relationships. This allows you to create a second (or third) content hierarchy in parallel to the official one.
  5. Tags improve your search experience. You can search for tags and content that has tags. The default search component in CQ uses these mechanisms, so you can narrow the results down to those that are really relevant.
  6. Tags can be simple and sophisticated at the same time. To create a tag all you need is a word and the touch of a button - it is that simple. Afterwards you can also add a title and description to the tag to add more semantics. There are no limits on the labels you select for your tags.
  7. Tags are integral to Web Content Management, Digital Asset Management and Social Collaboration within CQ. The tagging system is a core component of CQ and is used by all CQ Applications to categorize content. Additionally, tagging is available to developers for their own tagging-enabled applications.
  8. Tags can be created by anyone who needs a quick way to annotate a page. This helps with search-engine optimization, as tags will automatically show up in the metatags of the page, thus ensuring your page will be found by search engines.
  9. Tags have many names and faces: tags, taxonomy terms, categories, labels and many more. They are flexible in their content model and in the way they can be used; for instance, when outlining target demographics, categorizing and rating content or to create a secondary content hierarchy.
  10. CQ is ideal for dealing with structured information, thanks to the nesting of pages and paths. It is also extremely powerful when dealing with unstructured information, due to the built-in full-text search. Tagging allows you to combine the strengths of both structure and flexibility.

When designing the content structure for your site, or the metadata schema for your Digital Asset Management, consider the options tagging gives you, as it often provides a more lightweight and accessible approach.

Managing Tags using the Tag Administration console

The Tag Administration console can be used to manage your tags and taxonomies.

It shows information about the tags already created for your website, and a count of how often they are referenced in the website:


From here you can perform various actions on tags and/or namespaces.

Creating Tags and Namespaces

  1. Depending on the level you are starting from you can create either a tag or a namespace using New:

    If you select Tags you can create a namespace:


    If you select a namespace (for example Demo) you can create a tag within that namespace:

  2. In both cases enter a name, title, and description then click Create.

Editing Tags

  1. In the right-hand pane, select the tag that you want to edit.

  2. Click Edit.

  3. You can modify the Title and the Description.

  4. Click Save to close the dialog.

Deleting Tags

  1. In the right-hand pane, select the tag that you want to delete.

  2. Click Delete.

  3. Click Yes to close the dialog.

    The tag shouldn't be listed anymore.

Activating and Deactivating Tags

  1. In the right-hand pane, select the namespace or tag that you want to activate or deactivate.

  2. Click Activate or Deactivate as required.

List - showing where tags are referenced

List opens a new window showing the paths of all pages using the highlighted tag:


Moving Tags

To help tags administrators and developers clean up the taxonomy or rename a tag ID, CQ offers the possibility since the 5.4 version to move a tag to a new location:

  1. Open the Tagging console.

  2. Select the tag and click Move... in the top tool bar (or in the context menu).

  3. In the Move Tag dialog, define:

    • to, the destination node.
    • Rename to, the new node name.
  4. Click Move.

The Move Tag dialog looks as follows:



Authors should not move tags or rename a tag ID, they should change the tag titles if necessary.

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 more available to authors.

To merge a tag into another one:

  1. Open the Tagging console.

  2. Select the tag and click Merge... in the top tool bar (or in the context menu).

  3. In the Merge Tag dialog, define:

    • into, the destination node.
  4. Click Merge.

The Merge Tag dialog looks as follows:


Counting Usage of Tags

To see how many times a tag is being used:

  1. Open the Tagging console.

  2. Click Count usage in the top tool bar: the column Count displays the result.

Managing Tags in Different Languages

Since CQ 5.4 it is possible to define a tag title in several languages. Tag titles can then be localized either according to the user language or to the page language.

Defining Tag Titles in Multiple Languages

The following procedure shows how to define the title of the tag Animals in English, German and French:

  1. Go to the Tagging console.

  2. Edit the tag Animals below Tags > Stock Photography.

  3. Add the translations in the following languages:

    • English: Animals
    • German: Tiere
    • French: Animaux
  4. Save the changes.

The dialog looks as follows:


The Tagging console uses the author language, so for the Animal tag, 'Animaux' is displayed for a user who sets the language to French in the user properties.

To add a new language to the dialog, please refer to the section Adding a New Language to the Edit Tag Dialog in the Tagging for Developers page.

Displaying the Tag Titles of a Page in a Different Language

By default the tag titles in the page properties are displayed in the page language. The tag dialog in the page properties has a language field that enables to display the tag titles in a different language. The following procedure describes how to display the tag titles in French:

  1. Refer to the previous section to add the French translation to the Animals below Tags > Stock Photography.

  2. Open the page properties of the Products page in the English branch of the Geometrixx site.

  3. Open the Tags/Keywords dialog, select the Stock Photography tab and add the Animals tag to the page.

  4. In the bottom right corner of the dialog, select the French language. The tag title is displayed in French.

The tag dialog looks as follows:


Per default the Page Properties dialog displays the tag names according to the page language.

The language of the tag is taken from the page language if the page language is available. When the tag widget is used in other cases (for example in forms or in dialogs), the tag language depends on the context.


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