# Mail Templates

> Manage email templates for your system.

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/mail-templates` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `MailTemplatesPage` |
| Source | `src/app/(app)/admin/mail-templates/page.tsx` |
| Dynamic | no |

| Title i18n key | `admin.mail_templates.title` |
| Description i18n key | `admin.mail_templates.subtitle` |
| Permission | `admin.template.email.view` |
| Nav group | `content` |
| Sidebar label | Mail Templates |

## Summary (for AI)

**Mail Templates** Manage email templates for your system. Requires permission `admin.template.email.view`. Key UI: Are you sure you want to delete this template? This action cannot be undone.; Template; Edit; Delete; Reusable HTML email layouts for notifications, onboarding, invoices, and more.; Send an HTML email to all users. Use responsibly and ensure SMTP is configured..

## How to guide users

1. Open Admin sidebar.
2. Go to **Mail Templates**.
3. Direct URL: `/admin/mail-templates`.
4. User needs permission `admin.template.email.view` (or `admin.root`).

## Sections on this page

- What are Mail Templates?
- Mass Email
- Legal & Compliance

## Notable UI actions / labels

- Are you sure you want to delete this template? This action cannot be undone.
- Template
- Edit
- Delete
- Reusable HTML email layouts for notifications, onboarding, invoices, and more.
- Send an HTML email to all users. Use responsibly and ensure SMTP is configured.
- Update your Privacy Policy and Terms to reflect bulk messaging usage.
- Create Template
- Fill in the details to create a new email template.
- Template Preview
- Edit Template
- Send Mass Email

## Widget slugs

- [`admin-mail-templates`](../widgets/admin-mail-templates.md)

## Related APIs / hooks

- `/api/admin/mail-templates`
- `/api/admin/mail-templates/mass-email`
- `/api/admin/mail-templates/test-email`

Hooks: `usePersistedListFilters`, `usePluginWidgets`