Source: https://cli.nylas.com/docs/commands/template-list

# nylas template list

List hosted templates

Written by [Qasim Muhammad](https://cli.nylas.com/authors/qasim-muhammad) Staff SRE

Published February 13, 2026

Updated June 21, 2026

## What does nylas template list do?

The nylas template list command lists hosted templates. It is part of the Hosted Templates commands, which application or grant-scoped templates managed via the Nylas API. Use --json for structured output in scripts and automation.

## Usage

```bash
nylas template list
```

## Flags

| Flag | Description |
| --- | --- |
| --grant-id string | Grant ID or email for grant-scoped templates |
| --limit int(-n) | Maximum number of items to show |
| --page-token string | Page token for pagination |
| --scope string | Template scope: app or grant |
| --json | Output as JSON |
| --no-color | Disable color output |
| --verbose(-v) | Enable verbose output |
| --config | Custom config file path |
| --help(-h) | Show help for the command |
| --yes(-y) | Skip confirmations |

## Examples

The nylas template list command lists hosted templates.

### JSON output for scripting

```bash
nylas template list --json
```

### Limit the number of results

```bash
nylas template list --limit 10 --json
```

## Troubleshooting

### Command not found or fails

Run `nylas auth config` and `nylas auth login` to authenticate first.

## Related commands

[nylas template createCreate hosted template](https://cli.nylas.com/docs/commands/template-create)

[nylas template deleteDelete a template](https://cli.nylas.com/docs/commands/template-delete)

[nylas template renderRender with variables](https://cli.nylas.com/docs/commands/template-render)

[nylas template render-htmlRender inline HTML body](https://cli.nylas.com/docs/commands/template-render-html)

[nylas template showShow template details](https://cli.nylas.com/docs/commands/template-show)

[nylas template updateUpdate a template](https://cli.nylas.com/docs/commands/template-update)

## Recommended guides

[List Fastmail emails from the CLIList Fastmail emails from the CLI through Nylas IMAP access, using app passwords, inbox filters, JSON output, and Fastmail-specific auth troubleshooting.](https://cli.nylas.com/guides/list-fastmail-emails)

[Google Calendar API Sync TokensUse Google Calendar API sync tokens for incremental event sync, handle the 410 GONE full-resync, and read calendars from the CLI.](https://cli.nylas.com/guides/google-calendar-api-sync-tokens)

[Microsoft Graph calendarView ExplainedQuery the Microsoft Graph calendarView endpoint for events in a date range with recurrences expanded. Compare it to list events and read calendars from the CLI.](https://cli.nylas.com/guides/microsoft-graph-calendar-view)

[Why Cloud Servers Block SMTP PortsAWS, GCP, and Azure block outbound SMTP port 25 while ports 587 and 465 stay open. Confirm the block and send email over an HTTPS API instead.](https://cli.nylas.com/guides/smtp-ports-blocked-on-cloud-servers)

[Send Email From a Docker ContainerCloud providers block SMTP port 25 from containers. Send email over an HTTPS API on port 443 with one command and no mail daemon at all.](https://cli.nylas.com/guides/send-email-from-docker-container)

[MailerSend vs Nylas: Email ComparedMailerSend sends transactional email from verified domains. Nylas reads and syncs user inboxes across 6 providers. Compare features, pricing, and use cases.](https://cli.nylas.com/guides/mailersend-vs-nylas)

Run `nylas template list --help` for full help output.