Email Templates
Customize the OTP, Magic Link, and Welcome emails sent from each project
Overview
Each project has its own set of email templates, so the messages your end users receive match your branding instead of Hawcx's defaults. Edit the subject line, HTML body, and plain-text body for any template, in any of the supported locales, and preview the result with a real test send before saving.
Find it under Project Settings > Email Templates.
Template Types
| Type | Sent When |
|---|---|
| OTP Verification | A user requests a one-time passcode for authentication |
| Magic Link | A user requests a passwordless sign-in link |
| Welcome Email | A new user account is created |
Template Fields
| Field | Notes |
|---|---|
| Subject | Up to 200 characters |
| HTML body | Up to 100 KB |
| Plain-text body | Up to 10 KB. Sent alongside HTML for clients that don't render HTML |
| Locale | One of the supported locales below. Falls back to the project's default if a recipient's locale isn't configured |
Available Variables
Drop these into the subject, HTML, or text body using {{name}} syntax. Each template type accepts a different set; using a variable not on its list rejects the save. The editor shows the variables for the selected template type as click-to-insert chips next to the editor pane.
| Variable | OTP | Magic Link | Welcome | Description |
|---|---|---|---|---|
{{code}} | yes | yes | no | The verification code sent to the user |
{{link}} | no | yes | no | The passwordless sign-in URL |
{{company_name}} | yes | yes | yes | Your project's display name |
{{support_email}} | yes | no | no | Project support email address |
{{user_name}} | no | no | yes | The new user's display name |
{{login_url}} | no | no | yes | Your application's login URL |
OTP and Magic Link codes currently expire in 5 minutes (fixed). Reference "5 minutes" directly in your copy rather than using a variable.
Supported Locales
en-US, es, fr, de, ja. Each project picks one as its default; the others are optional.
Send a Test Email
Use Send test to deliver a fully rendered preview to any inbox. Variables are substituted with sample values so you can review the final message before customers see it.
Role-Based Access
| Role | Read | Edit |
|---|---|---|
| Hawcx Super Admin | yes | yes |
| Partner Super Admin | yes (own partner only) | yes (own partner only) |
| Customer Admin | yes | yes |
| Developer | yes (assigned projects) | yes (assigned projects) |
| Viewer | yes (assigned projects) | no |
Next Steps
- Projects for the broader Project Settings surface
- Roles & Permissions for who can edit what