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

# EmDash CMS

> Use our EmDash CMS plugin to send transactional emails from your EmDash CMS site.

## Getting Started

### Installation

1. Install the plugin in your [EmDash CMS](https://github.com/emdash-cms/emdash) project:

```bash theme={null}
npm install @jetemail/emdash-plugin
```

2. Add the plugin to your Astro config:

```js theme={null}
// astro.config.mjs
import { jetEmailPlugin } from "@jetemail/emdash-plugin/config";

export default defineConfig({
  integrations: [
    emdash({
      plugins: [jetEmailPlugin()],
    }),
  ],
});
```

Optionally, you can pass your API key at config time:

```js theme={null}
jetEmailPlugin({
  apiKey: process.env.JETEMAIL_API_KEY,
})
```

3. Navigate to **Plugins > JetEmail** in the EmDash CMS admin panel.
4. Enter your JetEmail Transactional API key. You can find your API key in the JetEmail dashboard under **Outbound > Keys** ([https://dash.jetemail.com](https://dash.jetemail.com)).
5. Configure your From Name and From Email address.
6. Save settings and send a test email.

### Configuration

| Setting          | Description                                          |
| ---------------- | ---------------------------------------------------- |
| **API Key**      | Transactional API key (starts with `transactional_`) |
| **From Address** | Sender email on a verified domain                    |
| **From Name**    | Display name (optional)                              |

## Requirements

* An [EmDash CMS](https://github.com/emdash-cms/emdash) site
* A JetEmail account with a verified domain
* A transactional API key

## Features

* **Easy Setup** — Install the plugin, enter your API key, and you're ready to go
* **Full Email Coverage** — Handles authentication emails (magic links, password resets), form notifications, and all other transactional emails
* **Admin Panel** — Configure credentials and sender details directly from the EmDash CMS admin
* **Test Connection** — Send a test email to verify your configuration

## How It Works

The plugin registers as an EmDash CMS email provider using the `email:deliver` hook. Once activated, all email sent by EmDash CMS — including magic links, password resets, and form submissions — is routed through the JetEmail API.

## Support

For support, please visit our [Discord community](https://jetemail.com/discord) or contact your JetEmail account representative.