Email Inventory

This repo ships 14 email templates in packages/email-templates/src/emails/ covering authentication (magic link, OTP, password reset), account management (email change, deletion), and organization workflows (invitations).

All use React Email for rendering. Disable specific emails via Better Auth config in packages/better-auth/src/auth.ts by toggling feature flags or commenting out plugin registrations.

This guide is part of the Email Configuration documentation.

The email inventory is the complete set of transactional email templates that ship with the repo, organized by workflow category.

Overview

The repo ships with 14 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)

Authentication Emails

Account Management Emails

Organization Emails

Admin Emails (Templates Only)

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

Disabling Emails

Email sending is configured in packages/better-auth/src/auth.ts. Below are the options for disabling specific email types.

Disable Email Verification on Signup

emailVerification: {
  sendOnSignUp: false, // Disable verification email on signup
  autoSignInAfterVerification: true,
  sendVerificationEmail: async ({ user, url, token }, request) => {
    await sendVerificationEmail({ user, url, token });
  },
},

Disable Email Change Feature

user: {
  changeEmail: {
    enabled: false, // Disables both confirmation and verification emails
  },
},

Disable Account Deletion Feature

user: {
  deleteUser: {
    enabled: false, // Disables delete account OTP email
  },
},

Disable Magic Link Authentication

Remove the magic-link plugin from packages/better-auth/src/auth.ts.

plugins: [
  // createMagicLinkPlugin(),
]

Disable OTP Authentication

Remove the OTP plugin in packages/better-auth/src/auth.ts to disable OTP-related emails (sign-in, email verification, password reset).

plugins: [
  // createOTPAuthPlugin(),
]

Disable Organization Invitations

To prevent invitation emails, modify the organization plugin in packages/better-auth/src/plugins/organizations.ts:

export const organizationPlugin = organization({
  // ...other options
  sendInvitationEmail: async (data) => {
    // Comment out or conditionally skip
    // return sendInvitationEmail(data);
  },
});

Template Locations

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

packages/email-templates/src/emails/
├── magic-link.email.tsx
├── email-verification.email.tsx
├── verification.email.tsx           # Generic verification component
├── reset-password.email.tsx
├── otp.email.tsx                    # Generic OTP base template
├── otp-sign-in.email.tsx
├── otp-email-verification.email.tsx
├── otp-password-reset.email.tsx
├── change-email-confirmation.email.tsx
├── delete-account-otp.email.tsx
├── invite.email.tsx
├── user-banned.email.tsx
├── user-unbanned.email.tsx
└── account-delete.email.tsx

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

When we built MakerKit's email system, we deliberately kept admin emails (banned, unbanned, deleted) as templates only - wiring them requires explicit admin panel integration, which varies per use case.

Common Pitfalls

• Disabling verification but keeping sign-up enabled: Users can sign up with fake emails. Either require verification or use OAuth-only authentication.
• Forgetting both OTP and link-based auth: If you disable the OTP plugin, ensure magic link or password auth is still enabled. Disabling all auth methods locks users out.
• Template changes not taking effect: Run pnpm build in the email-templates package after changes. The render function uses compiled output.
• Missing sendInvitationEmail implementation: The organization plugin expects a sendInvitationEmail function. If you remove it, invitation sending silently fails.
• Admin emails not wired: user-banned, user-unbanned, and account-delete templates exist but aren't automatically sent. You must call them from your admin panel actions.

Next: Custom Mailer →