> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.neetorecord.com/llms.txt
> Use this file to discover all available pages before exploring further.

# tags

> List the recording tags used in the workspace.

Tags label recordings for filtering and search. They are created implicitly:
passing a name that does not exist yet to
[`recordings update --tag`](/cli-reference/recordings#recordings-update) creates
the tag, so there is no separate create command. For fields and response
details, see the [API reference](/api-reference/tags/list).

<Info>
  Sample output on this page is the JSON envelope you get with `--json`. On a
  terminal the same data prints as a table or a key-value list. See
  [Output formats](/cli/output-formats).
</Info>

## tags list

Lists every tag in the workspace with the number of recordings carrying it. Use
it to check the exact spelling of a tag before passing it to
`recordings update`.

```bash theme={"system"}
neetorecord tags list
```

| Flag          | Type  | Required | Default | Description              |
| ------------- | ----- | -------- | ------- | ------------------------ |
| `--page`      | `int` |          | `0`     | Page number              |
| `--page-size` | `int` |          | `0`     | Items per page (max 100) |

```json theme={"system"}
{
  "data": [
    {
      "id": "b21f7c90-4d3e-4a15-9c68-0f2e8b7a6d54",
      "name": "demo",
      "style": "secondary",
      "recording_count": 12
    }
  ],
  "pagination": {
    "total_records": 15,
    "total_pages": 1,
    "current_page_number": 1,
    "page_size": 30
  }
}
```