← All playbooks · Raw API

task-taxonomy

# Capability: Taxonomy setup

## Intent phrases

- create tags
- set up taxonomy
- add tag types and tags

## Requires capabilities

`tags`

## Prerequisites

- `cms_edit ["index", "sync"]`

## Steps

**From JSON (batch):**

```
cms_edit ["create", "taxonomy-from-json", "--json", "<taxonomy-json>", "--if-not-exists"]
```

**Individual entries:**

```
cms_edit ["create", "tag-type", "--slug", "topic", "--name", "Topic", "--if-not-exists"]
cms_edit ["create", "tag", "--slug", "mental-health", "--name", "Mental Health", "--tag-type-slug", "topic", "--if-not-exists"]
```

Verify:

```
cms_edit ["list", "--type", "tagType"]
cms_edit ["list", "--type", "tag"]
```

## Confirmation gates

1. Show taxonomy plan before import
2. Summarize created vs existing IDs

## Out of scope

- Publish
- Assigning tags to articles (see **Article tags** capability)

## Related resources

- `cms-edit://customer/routing`