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

> Pull templates and their variants from a SuprSend workspace to local files

Pull templates and all their variants from a SuprSend workspace into your local directory. Each template — including all its channel content, variant definitions, conditions, and mock data — is written to a local file that you can edit and push back.

This action does not delete existing local files. Templates with the same slug are overwritten; new slugs are created as new files.

By default, templates are saved to `./suprsend/templates/`. Use `--dir` to change this. Specifying a directory is recommended when working across multiple workspaces.

## Syntax

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

## Flags

| Flag                | Description                                                  | Default                |
| ------------------- | ------------------------------------------------------------ | ---------------------- |
| `-h, --help`        | Show help for the command                                    | –                      |
| `-g, --slug string` | Pull a single template by slug. Omit to pull all templates.  | –                      |
| `-m, --mode string` | Version to pull: `live` or `draft`                           | `live`                 |
| `-d, --dir string`  | Output directory for pulled template files                   | `./suprsend/templates` |
| `-f, --force`       | Use the default directory without prompting for confirmation | –                      |

## Example

```bash theme={"system"}
# Pull all live templates to the default directory
suprsend template pull

# Pull a single template by slug
suprsend template pull --slug order-shipped

# Pull all templates into a custom directory
suprsend template pull --dir ./my-templates

# Pull draft templates from production without a confirmation prompt
suprsend template pull --mode draft --workspace production --force

# Pull a specific template from production into a custom directory
suprsend template pull --slug order-shipped --workspace production --dir ./prod-templates
```

<Tip>
  After pulling, the local files serve as your source of truth for editing. Make changes to variant content, conditions, or mock data, then run `suprsend template push` to upload the changes as a draft, and `suprsend template commit` to make them live.
</Tip>