# Email diagnostics

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

Each Email error has a stable `code`. Its `docs` link opens the page of that code. This page lists all 22 codes, and [All diagnostics](https://vitehub.dev/docs/reference/diagnostics) lists every primitive.

## Runtime errors

| Code | What happened |
| --- | --- |
| [`EMAIL_AUTHENTICATION`](https://vitehub.dev/docs/email/diagnostics/email_authentication) | The \<driver\> Email provider rejected the credentials. |
| [`EMAIL_INVALID_MESSAGE`](https://vitehub.dev/docs/email/diagnostics/email_invalid_message) | The \<driver\> Email driver rejected the message. |
| [`EMAIL_NETWORK`](https://vitehub.dev/docs/email/diagnostics/email_network) | The \<driver\> Email driver could not reach its provider. |
| [`EMAIL_PROVIDER_FAILED`](https://vitehub.dev/docs/email/diagnostics/email_provider_failed) | Email delivery through \<driver\> failed. |
| [`EMAIL_RATE_LIMITED`](https://vitehub.dev/docs/email/diagnostics/email_rate_limited) | The \<driver\> Email provider rate limited the request. |
| [`EMAIL_TEMPLATE_RENDER_FAILED`](https://vitehub.dev/docs/email/diagnostics/email_template_render_failed) (guide) | Email template "\<template\>" could not render with the `data` of this message. |
| [`EMAIL_TIMEOUT`](https://vitehub.dev/docs/email/diagnostics/email_timeout) | Email delivery through \<driver\> timed out. |

## Configuration errors

| Code | What happened |
| --- | --- |
| [`EMAIL_INVALID_DRIVER`](https://vitehub.dev/docs/email/diagnostics/email_invalid_driver) | See the page of the code. |
| [`EMAIL_NOT_CONFIGURED`](https://vitehub.dev/docs/email/diagnostics/email_not_configured) (guide) | The options of the \<driver\> Email driver are not valid. |

## Build errors

| Code | What happened |
| --- | --- |
| [`EMAIL_DUPLICATE_TEMPLATE`](https://vitehub.dev/docs/email/diagnostics/email_duplicate_template) | Two Email templates have the name \<name\>. |
| [`EMAIL_HOST_UNSUPPORTED`](https://vitehub.dev/docs/email/diagnostics/email_host_unsupported) | The "cloudflare" driver needs a Cloudflare host. |
| [`EMAIL_INVALID_OUTBOX`](https://vitehub.dev/docs/email/diagnostics/email_invalid_outbox) | See the page of the code. |
| [`EMAIL_INVALID_REMOTE`](https://vitehub.dev/docs/email/diagnostics/email_invalid_remote) | `email.remote` must be a boolean. |
| [`EMAIL_INVALID_TEMPLATE`](https://vitehub.dev/docs/email/diagnostics/email_invalid_template) | The Email template import \<id\> is not valid. |
| [`EMAIL_REMOTE_REQUIRED`](https://vitehub.dev/docs/email/diagnostics/email_remote_required) | `email.outbox` is `false`, so a `vite dev` send has no outbox to stay in. |
| [`EMAIL_SECRET_DEFAULT`](https://vitehub.dev/docs/email/diagnostics/email_secret_default) | The secret Email option \<path\> has a default, and defaults are included in build output. |
| [`EMAIL_SYNC_OPTION_REQUIRED`](https://vitehub.dev/docs/email/diagnostics/email_sync_option_required) | The Email option \<path\> uses `env.provider()`, and Email resolves its options synchronously. |
| [`EMAIL_UNKNOWN_DRIVER`](https://vitehub.dev/docs/email/diagnostics/email_unknown_driver) | `email.driver` is \<driver\>. ViteHub renamed this driver to "\<renamed\>", and it does not read \<driver\>. |

## Tool errors

| Code | What happened |
| --- | --- |
| [`EMAIL_CLI_USAGE`](https://vitehub.dev/docs/email/diagnostics/email_cli_usage) | See the page of the code. |

## Operation errors

| Code | What happened |
| --- | --- |
| [`EMAIL_OUTBOX_DISABLED`](https://vitehub.dev/docs/email/diagnostics/email_outbox_disabled) | The Email development outbox is disabled. |
| [`EMAIL_OUTBOX_MESSAGE_NOT_FOUND`](https://vitehub.dev/docs/email/diagnostics/email_outbox_message_not_found) | Outbox message was not found. The outbox keeps only recent messages and a restart clears it. |
| [`EMAIL_TEMPLATE_NOT_FOUND`](https://vitehub.dev/docs/email/diagnostics/email_template_not_found) | Email template "\<template\>" was not found in \<roots\>. \<value\> |

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/email.md)
- [Get started](https://vitehub.dev/raw/docs/email/get-started.md)
- [Configure](https://vitehub.dev/raw/docs/email/configure.md)
- [Server API](https://vitehub.dev/raw/docs/email/server-api.md)
- [Agent capability](https://vitehub.dev/raw/docs/email/agent-capability.md)
- [Hosts](https://vitehub.dev/raw/docs/email/hosts.md)
- [Limits and errors](https://vitehub.dev/raw/docs/email/limits-and-errors.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
