Email Templates
Customize the OTP, Magic Link, and Welcome emails sent from each project
Overview
Use email templates to control the messages Hawcx sends during authentication and onboarding. Each project has its own templates, so the emails your users receive can match the application they are signing in to instead of using Hawcx defaults.
You can edit the subject line, HTML body, and plain-text body for each template, configure localized versions, and send a rendered test email before saving changes.
Find templates under Project Settings > Email Templates.
The video below shows where Email Templates lives in project settings and how to open the template management screen.
Template types
Hawcx sends different templates at different points in the user journey.
| 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
Each template includes the same editable fields. Use the HTML body for rich email clients and the plain-text body as the fallback for clients that do not render HTML.
The video below shows the create-template flow, including choosing a template type, editing template fields, and preparing a new template for review.
| 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
Variables let you insert authentication codes, links, and project details into a template without hardcoding them. Add variables to the subject, HTML body, or text body using {{name}} syntax.
Each template type accepts a different set of variables. If you use a variable that is not allowed for the selected template, Hawcx rejects the save. The editor also shows the available variables for the selected template 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
Each project has a default locale, and you can add localized templates for other supported locales when you need translated copy.
Supported locales: en-US, es, fr, de, ja.
If a recipient's locale does not have a configured template, Hawcx falls back to the project's default locale.
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 subject and body before customers see the message.
Send a test email whenever you change copy, add variables, or update localized content. It is the fastest way to catch broken HTML, missing fallback text, or wording that looks different in an actual inbox.
Role-based access
Access follows the same project permissions used elsewhere in the console.
| 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 templates