Skip to main content
Metadata in Cognite documentation articles enables localization, reporting, search discoverability, and site experience customization. Add metadata in the YAML frontmatter at the top of each Markdown file.
Canonical source for agents: Allowed values and validation rules live in .agents/skills/content-metadata/SKILL.md in this repository. This article is the human-readable reference; when the two differ, the skill is authoritative.
Metadata values are case-sensitive.
Every article must include all required fields. If you are editing an existing article, check that the required fields are present and correct.

Example YAML frontmatter

Required fields

Every article must include all of the following fields.

Optional fields

Content metadata fields

The following fields are required in every article. They classify articles for reporting, search discoverability, and AI answer precision.

Audience

The audience field defines the main target audience for the article. Valid values for the audience field:

Content type

The content-type field defines the type of content in the article. It matches the content types defined in the content model. Valid values for the content-type field:

Article type

The article-type field defines the type of article, map topic or article, and is used for reporting. Valid values for the article-type field:

Experience level

We use the experience-level field to define the experience level we expect the reader of the article to have. It is used for reporting. Valid values for the experience-level field:

Lifecycle

We use the lifecycle field to define which part of the customer lifecycle the article is intended for. It is used for reporting. Valid values for the lifecycle field:
Last modified on August 27, 2026