> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aspfox.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Customizing Email Templates
> Change copy, update brand colors, add a logo, and create new email templates.
## Where templates live
All email templates are in `src/Acme.Infrastructure/Email/Templates/`. Each template is a C# class that extends `EmailTemplateBase`.
```
src/Acme.Infrastructure/Email/Templates/
├── EmailTemplateBase.cs ← base class with HTML scaffolding
├── WelcomeTemplate.cs
├── EmailVerificationTemplate.cs
├── PasswordResetTemplate.cs
├── MagicLinkTemplate.cs
├── PasswordChangedTemplate.cs
├── TenantInvitationTemplate.cs
├── TrialExpiry7DayTemplate.cs
├── TrialExpiry1DayTemplate.cs
├── PaymentFailedTemplate.cs
├── PaymentRecoveredTemplate.cs
├── CancellationScheduledTemplate.cs
└── CancellationConfirmedTemplate.cs
```
## How templates work
`EmailTemplateBase` provides:
* The outer HTML envelope (DOCTYPE, ``, brand color, inline styles)
* Header with the application name
* Footer with unsubscribe language
* Abstract `RenderContent()` method that each template implements
Each template class fills in `RenderContent()` with its specific body HTML:
```csharp theme={null}
// EmailVerificationTemplate.cs
public class EmailVerificationTemplate : EmailTemplateBase
{
private readonly string _userName;
private readonly string _verificationUrl;
public EmailVerificationTemplate(string userName, string verificationUrl)
{
_userName = userName;
_verificationUrl = verificationUrl;
}
protected override string RenderContent()
{
return $"""
Verify your email address
Hi {_userName}, click the button below to verify your email address.
This link expires in 24 hours.
Verify Email
""";
}
}
```
## Changing the brand color
The primary color is set in one place in `EmailTemplateBase`:
```csharp theme={null}
// EmailTemplateBase.cs
private const string PrimaryColor = "#1A56DB";
```
Change this value and it propagates to every template header, button, and accent element.
## Changing email copy
Find the relevant template class, edit the string in `RenderContent()`. The C# raw string literal (`"""..."""`) makes multi-line HTML easy to write and read.
## Adding a logo
Replace the text-based header in `EmailTemplateBase.RenderHeader()` with an `![]()
` tag:
```csharp theme={null}
// Before:
private string RenderHeader() => $"""
Acme
""";
// After (host your logo somewhere publicly accessible):
private string RenderHeader() => $"""
""";
```
## Adding a new template
**Step 1:** Add a value to the `EmailTemplate` enum in `Domain`:
```csharp theme={null}
// src/Acme.Domain/Enums/EmailTemplate.cs
public enum EmailTemplate
{
// existing values...
WeeklyDigest,
}
```
**Step 2:** Create the template class:
```csharp theme={null}
// src/Acme.Infrastructure/Email/Templates/WeeklyDigestTemplate.cs
public class WeeklyDigestTemplate : EmailTemplateBase
{
private readonly string _userName;
private readonly int _newProjects;
public WeeklyDigestTemplate(string userName, int newProjects)
{
_userName = userName;
_newProjects = newProjects;
}
protected override string RenderContent()
{
return $"""
Your weekly digest
Hi {_userName}, here's what happened this week:
- {_newProjects} new project(s) created
""";
}
}
```
**Step 3:** Add a case in `ResendEmailService.SendTemplateAsync`:
```csharp theme={null}
// src/Acme.Infrastructure/Email/ResendEmailService.cs
EmailTemplate.WeeklyDigest => new WeeklyDigestTemplate(
model.UserName,
model.NewProjects
),
```
## Testing email rendering locally
Dump a template to HTML and open it in a browser — no SMTP server needed:
```csharp theme={null}
// Scratch: add temporarily to any endpoint or test
var template = new WeeklyDigestTemplate("Jane", 3);
var html = template.Render();
await File.WriteAllTextAsync("/tmp/weekly-digest-preview.html", html);
```
Then open `/tmp/weekly-digest-preview.html` in your browser. Delete this code before committing.
For sends that actually went through, check the **Emails** tab in the Resend dashboard — it shows the full rendered HTML, delivery timestamp, and open/click events.
