Email Inventory

Complete list of all emails shipped by default and how to disable each.

Email Inventory

Complete inventory of all emails and configuration options.

1

Overview

2

Authentication Emails

3

Account Management Emails

4

Organization Emails

5

Disabling Emails

Overview

The kit ships with 15 email templates covering authentication, account management, and organization workflows. All templates are located in packages/email-templates/src/emails/ and use React Email for rendering.

Emails are categorized into:

  1. Authentication Emails - Sign-in, verification, password reset
  2. Account Management Emails - Email changes, account deletion
  3. Organization Emails - Team invitations
  4. Admin Emails - User moderation (templates exist, not wired yet)
  5. Generic Templates - Reusable templates for custom use cases

Authentication Emails

EmailTemplateWhen Sent
Magic Linkmagic-link.email.tsxUser requests passwordless sign-in via magic link
Email Verificationemail-verification.email.tsxNew user signs up (link-based verification)
Reset Passwordreset-password.email.tsxUser requests password reset
OTP Sign-Inotp-sign-in.email.tsxUser signs in via OTP code
OTP Email Verificationotp-email-verification.email.tsxNew user signs up (OTP-based verification)
OTP Password Resetotp-password-reset.email.tsxUser resets password via OTP code

Account Management Emails

EmailTemplateWhen Sent
Change Email Confirmationchange-email-confirmation.email.tsxUser initiates email change (sent to current email)
Change Email Verificationchange-email-verification.email.tsxUser changes email (sent to new email)
Delete Account OTPdelete-account-otp.email.tsxUser initiates account deletion

Organization Emails

EmailTemplateWhen Sent
Invitationinvite.email.tsxMember is invited to join an organization

Admin Emails (Templates Only)

These templates exist but are not currently wired to send automatically:

EmailTemplatePurpose
User Banneduser-banned.email.tsxNotify user their account was suspended
User Unbanneduser-unbanned.email.tsxNotify user their account was restored
Account Deletedaccount-delete.email.tsxConfirm account deletion

Generic Templates

Reusable email templates for building custom emails:

EmailTemplatePurpose
OTPotp.email.tsxGeneric OTP email with i18n support. Used as base for sign-in, verification, and password reset OTPs
Verificationverification.email.tsxFlexible verification template with customizable heading, body, code label, and optional warning message

Using the Generic Verification Template

The verification.email.tsx template accepts these props:

interface Props {
  code: string;           // The verification code to display
  productName: string;    // Name shown in footer
  heading: string;        // Email heading
  body: string;           // Main body text
  codeLabel: string;      // Label before the code
  warning?: string;       // Optional warning message (shown in red)
  variant?: 'default' | 'destructive';  // Button style
}

Using the Generic OTP Template

The otp.email.tsx template accepts these props and supports internationalization:

interface Props {
  otp: string;            // The one-time password code
  productName: string;    // Name of the product/service
  language?: string;      // Language code for i18n
}

Template Locations

All email templates are in packages/email-templates/src/emails/:

packages/email-templates/src/emails/
├── account-delete.email.tsx
├── change-email-confirmation.email.tsx
├── change-email-verification.email.tsx
├── delete-account-otp.email.tsx
├── email-verification.email.tsx
├── invite.email.tsx
├── magic-link.email.tsx
├── otp.email.tsx
├── otp-email-verification.email.tsx
├── otp-password-reset.email.tsx
├── otp-sign-in.email.tsx
├── reset-password.email.tsx
├── user-banned.email.tsx
├── user-unbanned.email.tsx
├── verification.email.tsx

To customize an email template, edit the corresponding file and the changes will apply to all sent emails.