Skip to main content

A Tag is a reusable resource that can be linked to one or more content or asset entries. The linking of tags to entries allows those entries to be grouped by and retrieved on the basis of how they have been tagged, helping you organise and classify content for easier filtering, searching, and reporting.

A Tag belongs to a single Tag group and a single entry can link multiple tags from a tag group via one or more Tag picker fields assigned to the Content Type.

Tags from multiple tag groups can be used by including a Tag picker field for each Tag group we wish to link tag(s) from.

Properties

NameTypeDescription
idstringThe tag GUID identifier
groupIdstringThe tag's parent tag group GUID identifier
valuestringA simple string representing the value of the tag
labelLocalizedStringObject containing a key for each language code supported by the project (minimum primaryLanguage) and the value of each key represents the localized label
usageCountnumberThe number of places the tag is linked from
versionVersionInfoThe version object containing details of creation, modification and a versionNo in the format "1.0"

Example

This example JSON shows a tag as it is retrieved from the Management API

json
{
  "groupId": "topics",
  "id": "109eb3e9-98c9-5ab2-b9df-f1c80af3ac5c",
  "value": "books",
  "label": {
    "en-GB": "Books",
    "cy": "Llyfrau",
    "fr-FR": "Livre"
  },
  "version": {
    "versionNo": "1.0",
    "created": "2025-06-25T14:09:59.877Z",
    "createdBy": "zengenti",
    "modified": "2025-06-25T14:09:59.877Z",
    "modifiedBy": "zengenti"
  },
  "usageCount": 0
}

Still need help?

If you still need help after reading this article, don't hesitate to reach out to the Contensis community on Slack or raise a support ticket to get help from our team.
New support request