> ## 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.

# Pull Category

> Pull categories from a workspace

Download preference categories and their translations from a workspace to local files. Saves `categories_preferences.json` and locale-specific translation files to the output directory. <br /><br />
By default, pulled categories are stored in the `suprsend/category/` directory, but you can change the destination using the `-d, --dir` flag.

## Syntax

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

## Flags

| Flag                | Description                                          | Default               |
| ------------------- | ---------------------------------------------------- | --------------------- |
| `-h, --help`        | Show help for the command                            | –                     |
| `-d, --dir string`  | Directory to save category files to                  | `./suprsend/category` |
| `-f, --force`       | Skip directory confirmation prompt, use default path | –                     |
| `-m, --mode string` | Version mode (`draft` or `live`)                     | `live`                |

## Example

```bash theme={"system"}
# Pull all live categories to default directory
suprsend category pull

# Pull categories into custom directory path
suprsend category pull --dir categories

# Pull categories from production workspace
suprsend category pull --workspace production

# Pull draft categories
suprsend category pull --mode draft
```