# Email Templates {#email-templates}


Customize system email notifications using Handlebars templates.


## Overview {#overview}


Gauzy uses a template engine for all outgoing emails. Each template is stored in the database and can be customized per tenant and language.


## Template Technology {#template-technology}


| Component      | Description                       |
| -------------- | --------------------------------- |
| **MJML**       | Responsive email markup framework |
| **Handlebars** | Template variable interpolation   |


## Built-in Templates {#built-in-templates}


| Template             | Trigger                    |
| -------------------- | -------------------------- |
| `WELCOME_USER`       | New user registration      |
| `PASSWORD_RESET`     | Password reset request     |
| `INVITE_EMPLOYEE`    | Employee invitation sent   |
| `INVITE_USER`        | User invitation sent       |
| `TIME_OFF_APPROVED`  | Time-off request approved  |
| `TIME_OFF_REJECTED`  | Time-off request rejected  |
| `INVOICE`            | Invoice sent to contact    |
| `ESTIMATE`           | Estimate sent to contact   |
| `EMAIL_VERIFICATION` | Email address verification |


## Customizing Templates {#customizing-templates}


1. Navigate to **Settings** → **Email Templates**
2. Select the template to customize
3. Edit the Handlebars HTML
4. Preview the rendered output
5. Save changes


## Template Variables {#template-variables}


Templates use Handlebars syntax for dynamic content:

```handlebars
<h1>Welcome, {{name}}!</h1>
<p>Your organization <strong>{{organizationName}}</strong> is ready.</p>
<a href="{{host}}/auth/login">Log in now</a>
```

Common variables:

| Variable               | Description          |
| ---------------------- | -------------------- |
| `{{name}}`             | Recipient name       |
| `{{email}}`            | Recipient email      |
| `{{organizationName}}` | Organization name    |
| `{{host}}`             | Application host URL |
| `{{token}}`            | Security token       |


## Multi-language Support {#multi-language-support}


Templates support multiple languages — each template can have versions for each locale.


## API Reference {#api-reference}


See [Email Template Endpoints](https://sourcey-gauzy.pages.dev/api/email-template-endpoints/index.md) for the API documentation.


## Related Pages {#related-pages}


- [Custom SMTP](https://sourcey-gauzy.pages.dev/features/custom-smtp/index.md) — email delivery configuration
- [Employee Notifications](https://sourcey-gauzy.pages.dev/features/employee-notifications/index.md) — notification settings