README

Design and manage your Craft CMS email templates directly from the control panel — no Twig files, no deployments, no code required.

Official plugin page: https://plugins.craftcms.com/email-templates

Overview

Did you ever get a complaint from clients or editors about the look of their password reset emails? Or want to add a logo and custom colors to the default user registration email? Now you can allow them to design email templates themselves, right inside the Craft control panel.

Email Templates plugin adds a visual editor inside the Craft control panel (Utilities → Email Template). Authorized users can customize the look and feel of all outgoing system emails — colors, typography, logo, footer, social links — and see a live preview before saving.

Settings are stored in the database, not in project.yaml, so each environment can have its own design without triggering config changes or requiring deployments.

Requirements

• Craft CMS 5.0 or later
• PHP 8.2 or later
• Craft Pro edition (required for custom HTML email templates in Craft)

Installation

Install via Composer:

composer require frontend-services/craft-email-templates
php craft plugin/install email-templates

The plugin automatically registers itself as the active email template. No manual configuration in Settings → Email is required.

Features

Visual Editor

A no-code editor under Utilities → Email Template with live preview. Changes are saved to the database and take effect immediately.

Cross-Client Compatible Output

All generated HTML uses table-based layout with fully inlined styles — compatible with Gmail, Apple Mail, Outlook (2016+, 365, web), Yahoo Mail, and Thunderbird.

Multi-Site Support

Each site can have its own email template settings. The editor includes a site switcher when multiple sites are present, and a "Copy from site" shortcut. Emails are automatically matched to the correct site's settings at send time — including for queue-based email sends.

Import / Export

Template settings can be exported as a JSON file and imported into another environment or site — useful for staging-to-production workflows or sharing templates across projects.

Compatibility

Email Templates works with all standard Craft CMS system emails (user registration, password reset, email verification, etc.) as well as third-party plugins that send emails through Craft's mailer — Formie, MailCraft, etc.

Permissions

Access to the Email Template utility is controlled by Craft's permission system. Users require the Access the "Email Template" utility permission, which can be assigned per user group.

Template Settings Storage

Settings are stored in the emailtemplates_settings database table — not in project.yaml. It allows each environment (local, staging, production) to maintain its own email design independently without triggering project config changes or merge conflicts.

Support

• GitHub Issues