Taxonomy
Classify content with Vocabularies and Terms.
Taxonomy describes what an entry or asset is about. It does not create menus, folders, URLs, or page trees.
Concepts
- A Vocabulary is a Backend-scoped named set of Terms and owns one Field Set for custom Term values.
- A Taxonomy Term has stable identity, a key, localized label and description, optional parent, position, Active or Archived status, and optional custom values.
- A Taxonomy assignment stores one exact Term ID. It does not assign ancestors or descendants.
- Term changes are immediate metadata, not Content publication.
A Term can have one parent, and hierarchy depth is limited to 32. Archived Terms remain resolvable for existing assignments but are unavailable for new assignments. REST returns Term IDs in Content field values; GraphQL can populate Terms that the caller may read.
Access
Inspecting Taxonomy requires backend.read, scoped vocabulary.read, and scoped term.read; Term reads may also have Locale scope. Vocabulary changes use vocabulary.create, vocabulary.update, or vocabulary.delete. Term changes use term.create, term.update, term.move, or term.delete, with the scope required by that action.