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

# List Category

> List categories

List notification preference categories in a workspace. Returns a flattened table with root\_category, section, category\_name, default\_preference, and mandatory channels. Use `--mode` to switch between draft and live.

## Syntax

```bash theme={"system"}
suprsend category list [flags]
```

## Flags

| Flag                  | Description                              | Default  |
| --------------------- | ---------------------------------------- | -------- |
| `-h, --help`          | Show help for the command                | –        |
| `-m, --mode string`   | Version mode (`draft` or `live`)         | `live`   |
| `-o, --output string` | Output format (`pretty`, `json`, `yaml`) | `pretty` |

<Tip>
  Use `-o json` for machine-readable JSON output, `-o yaml` for YAML. Default `-o pretty` outputs a human-friendly table.
</Tip>

## Example

```bash theme={"system"}
# List categories in staging workspace (default)
suprsend category list

# List categories in production workspace
suprsend category list --workspace production

# List categories in draft mode
suprsend category list --mode draft

# List categories in JSON format
suprsend category list --output json
```