Authentik Email Templates

Create and edit professional email templates for Authentik SSO authentication flows. Use when working with Authentik email templates (.html files) for authentication events such as password reset, account confirmation, email verification, account exists notifications, invitations, or any other Authentik email communication. This skill provides templates, styling patterns, Django template syntax guidance, and deployment workflows for the avatar-deployment project. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

Install

Press C to copy

$ npx skillmds@latest add tomevault-io/authentik-email-templates

Installs into ~/.claude/skills (or .claude/skills inside a project). Restart Claude Code to pick it up.

＋ Add to collection

README badge

[![SkillMD](https://skillmd.com/badge/tomevault-io/authentik-email-templates.svg)](https://skillmd.com/skills/tomevault-io/authentik-email-templates)

Trust & safety

2 of 3 audits passed

Last audited Sep 18, 2026 · commit 05ebe6a

Works with: Claude Code Claude.ai OpenAI Codex +

File contents

Authentik Email Templates

Create professional, branded email templates for Authentik authentication flows.

Quick Start

Choose a base template from assets/ matching your email type
Customize content with appropriate text and Django variables (business casual tone, no emojis)
Apply color scheme from color-schemes.md based on email purpose
Test variables using authentik-variables.md
Save to correct location: common/authentik-templates/

Template Structure

All Authentik email templates follow this pattern per official documentation:

{# Django comment describing template purpose #}
{% load i18n %}
{# Optional: {% load humanize %} for time formatting #}
<!DOCTYPE html>
<html lang="en">
<head>
    <!-- Meta tags and title with {% trans %} tags -->
    <style>
        /* Inline CSS for email client compatibility */
    </style>
</head>
<body>
    <div class="email-container">
        <div class="header">
            <h1>{% trans 'Header Title' %}</h1>
        </div>
        <div class="content">
            {% blocktrans with username=user.username %}
            <p>Hello {{ username }},</p>
            {% endblocktrans %}
            <!-- Main email body with {{ url }} -->
        </div>
        <div class="footer">
            <!-- Standard Octopize footer -->
        </div>
    </div>
</body>
</html>

Critical Requirements

Per authentik documentation (https://docs.goauthentik.io/add-secure-apps/flows-stages/stages/email/):

Load i18n module: Start with {% load i18n %}
Use user.username: Not user.name - username is the correct variable
Use blocktrans for variables: Wrap personalized text in {% blocktrans with username=user.username %}
Format expires properly: Use {% blocktrans with expires=expires|naturaltime %} not raw {{ expires }}
Translate all static text: Wrap in {% trans 'Text' %} tags
No emojis: Keep all text emoji-free for professional communication

Available Templates

Use these as starting points:

base-template.html - General purpose with button action
notification-template.html - Info-only, no action button

Tone and Style

Tone: Business casual - professional yet approachable
No emojis: Keep headers clean and text-based
Clarity: Direct, clear language that respects user's time
Professionalism: Maintain Octopize brand standards

Common Email Types

Password Reset

Header: "Password Reset"
Color: Darker Teal gradient (Octopize brand)
Variables: {{ url }}, {{ expires|naturaltime }}, {{ user.username }}
Include: Warning box about expiration
Load modules: {% load i18n %} and {% load humanize %}

Account Confirmation

Header: "Welcome - Confirm Your Account"
Color: Primary Teal gradient (Octopize brand)
Variables: {{ url }}, {{ user.username }}
Include: Welcoming message
Load modules: {% load i18n %}

Account Already Exists

Header: "Registration Attempt Detected"
Color: Primary Teal gradient
Variables: {{ url }}
Include: Info box with password reset link
Load modules: {% load i18n %}

Invitation

Header: "You're Invited" or "Account Invitation"
Color: Primary Teal gradient
Variables: {{ url }}, {{ expires|naturaltime }}, {{ invitation }}
Load modules: `{% load i1 per https://docs.goauthentik.io/add-secure-apps/flows-stages/stages/email/

Essential Patterns

{# Comments #}
{% load i18n %}  {# Required for all templates #}
{% load humanize %}  {# Required when using expires|naturaltime #}

{# Translate static text #}
{% trans 'Static Text' %}

{# Translate text with variables #}
{% blocktrans with username=user.username %}
Hello {{ username }},
{% endblocktrans %}

{# Format expiration time #}
{% blocktrans with expires=expires|naturaltime %}
This link expires {{ expires }}.
{% endblocktrans %}

Available Variables

{{ url }} - Full URL for user action
{{ user.username }} - User's username (primary identifier)
{{ expires }} - Token expiration timestamp (use with |naturaltime)user.name|default:"there" }}

{% if condition %}...{% endif %} {% for item in list %}...{% endfor %}


See [authentik-variables.md](references/authentik-variables.md) for complete reference.

## Styling Guidelines

### Must-Have Elements

1. **Inline CSS** - Email clients don't support external stylesheets
2. **Max width 600px** - Optimal for mobile and desktop
3. **Web-safe fonts** - Segoe UI, Arial, sans-serif fallbacks
4. **Responsive design** - `viewport` meta tag, mobile-friendly buttons

### Color Usage

Match colors to email purpose using Octopize brand palette:
- **Teal (Primary)**: Welcome, confirmation, general communications
- **Darker Teal**: Security, passwords, authentication  
- **Amber**: Warnings, expiration notices
- **Red-Orange**: Critical alerts, account suspension

See [color-schemes.md](references/color-schemes.md) for exact color codes.

### Button Best Practices

```html
<center>
    <a href="{{ url }}" class="button">Action Text</a>
</center>
<p>Or copy and paste this link into your browser:</p>
<p style="word-break: break-all; color: #43e97b; font-size: 14px;">{{ url }}</p>

Always provide both button and plain text URL for accessibility.

Deployment Workflow

After creating/editing templates in common/authentik-templates/:

Sync to deployment targets:
```
./sync-templates.sh
```
This syncs to docker/authentik/custom-templates/ and services-api-helm-chart/static/emails/

⚠️ Never edit docker/authentik/custom-templates/ or services-api-helm-chart/static/emails/ directly - they are auto-synced.

File Naming Convention

Templates must match Authentik's expected names:

email_password_reset.html
email_account_confirmation.html
email_account_exists.html
Custom stages: Match the stage's template name configuration

Common Variables

Most frequently used:

{{ user.name }} - User's display name
{{ user.email }} - User's email
{{ url }} - Action URL (reset, confirm, etc.)
{{ expires }} - Link expiration in hours

Testing Checklist

Before deployment:

Business casual tone throughout
No emojis in headers or content
All Django variables render correctly
Button link uses {{ url }}
Fallback text URL included
Octopize brand colors applied correctly
Footer includes copyright year
Template comment at top describes purpose
No external CSS or JavaScript
Responsive on mobile preview

Examples from Codebase

Reference existing templates in common/authentik-templates/:

email_password_reset.html - Security-focused with warning box
email_account_confirmation.html - Professional welcome message
email_account_exists.html - Informative with helpful guidance

Additional Resources

Variables reference: authentik-variables.md
Color schemes: color-schemes.md
Authentik docs: https://goauthentik.io/docs/flow/stages/email/

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: authentik-email-templatesdescription: Create and edit professional email templates for Authentik SSO authentication flows. Use when working with Authentik email templates (.html files) for authentication events such as password reset, account confirmation, email verification, account exists notifications, invitations, or any other Authentik email communication. This skill provides templates, styling patterns, Django template syntax guidance, and deployment workflows for the avatar-deployment project. Use when this capability is needed.---# Authentik Email TemplatesCreate professional, branded email templates for Authentik authentication flows.## Quick Start1. **Choose a base template** from `assets/` matching your email type2. **Customize content** with appropriate text and Django variables (business casual tone, no emojis)3. **Apply color scheme** from [color-schemes.md](references/color-schemes.md) based on email purpose4. **Test variables** using [authentik-variables.md](references/authentik-variables.md) 5. **Save to correct location**: `common/authentik-templates/`## Template StructureAll Authentik email templates follow this pattern per official documentation:```html{# Django comment describing template purpose #}{% load i18n %}{# Optional: {% load humanize %} for time formatting #}<!DOCTYPE html><html lang="en"><head>  <style> /* Inline CSS for email client compatibility */ </style></head><body> <div class="email-container"> <div class="header"> <h1>{% trans 'Header Title' %}</h1> </div> <div class="content"> {% blocktrans with username=user.username %} <p>Hello {{ username }},</p> {% endblocktrans %}  </div> <div class="footer">  </div> </div></body></html>```## Critical RequirementsPer authentik documentation (https://docs.goauthentik.io/add-secure-apps/flows-stages/stages/email/):1. **Load i18n module**: Start with `{% load i18n %}`2. **Use user.username**: Not `user.name` - username is the correct variable3. **Use blocktrans for variables**: Wrap personalized text in `{% blocktrans with username=user.username %}`4. **Format expires properly**: Use `{% blocktrans with expires=expires|naturaltime %}` not raw `{{ expires }}`5. **Translate all static text**: Wrap in `{% trans 'Text' %}` tags6. **No emojis**: Keep all text emoji-free for professional communication## Available TemplatesUse these as starting points:- **base-template.html** - General purpose with button action- **notification-template.html** - Info-only, no action button## Tone and Style- **Tone**: Business casual - professional yet approachable- **No emojis**: Keep headers clean and text-based- **Clarity**: Direct, clear language that respects user's time- **Professionalism**: Maintain Octopize brand standards## Common Email Types### Password Reset- **Header**: "Password Reset"- **Color**: Darker Teal gradient (Octopize brand)- **Variables**: `{{ url }}`, `{{ expires|naturaltime }}`, `{{ user.username }}`- **Include**: Warning box about expiration- **Load modules**: `{% load i18n %}` and `{% load humanize %}`### Account Confirmation- **Header**: "Welcome - Confirm Your Account"- **Color**: Primary Teal gradient (Octopize brand)- **Variables**: `{{ url }}`, `{{ user.username }}`- **Include**: Welcoming message- **Load modules**: `{% load i18n %}`### Account Already Exists- **Header**: "Registration Attempt Detected"- **Color**: Primary Teal gradient- **Variables**: `{{ url }}`- **Include**: Info box with password reset link- **Load modules**: `{% load i18n %}`### Invitation- **Header**: "You're Invited" or "Account Invitation"- **Color**: Primary Teal gradient- **Variables**: `{{ url }}`, `{{ expires|naturaltime }}`, `{{ invitation }}`- **Load modules**: `{% load i1 per https://docs.goauthentik.io/add-secure-apps/flows-stages/stages/email/### Essential Patterns```django{# Comments #}{% load i18n %} {# Required for all templates #}{% load humanize %} {# Required when using expires|naturaltime #}{# Translate static text #}{% trans 'Static Text' %}{# Translate text with variables #}{% blocktrans with username=user.username %}Hello {{ username }},{% endblocktrans %}{# Format expiration time #}{% blocktrans with expires=expires|naturaltime %}This link expires {{ expires }}.{% endblocktrans %}```### Available Variables- `{{ url }}` - Full URL for user action- `{{ user.username }}` - User's username (primary identifier) - `{{ expires }}` - Token expiration timestamp (use with `|naturaltime`)user.name|default:"there" }}{% if condition %}...{% endif %}{% for item in list %}...{% endfor %}```See [authentik-variables.md](references/authentik-variables.md) for complete reference.## Styling Guidelines### Must-Have Elements1. **Inline CSS** - Email clients don't support external stylesheets2. **Max width 600px** - Optimal for mobile and desktop3. **Web-safe fonts** - Segoe UI, Arial, sans-serif fallbacks4. **Responsive design** - `viewport` meta tag, mobile-friendly buttons### Color UsageMatch colors to email purpose using Octopize brand palette:- **Teal (Primary)**: Welcome, confirmation, general communications- **Darker Teal**: Security, passwords, authentication - **Amber**: Warnings, expiration notices- **Red-Orange**: Critical alerts, account suspensionSee [color-schemes.md](references/color-schemes.md) for exact color codes.### Button Best Practices```html<center> <a href="{{ url }}" class="button">Action Text</a></center><p>Or copy and paste this link into your browser:</p><p style="word-break: break-all; color: #43e97b; font-size: 14px;">{{ url }}</p>```Always provide both button and plain text URL for accessibility.## Deployment WorkflowAfter creating/editing templates in `common/authentik-templates/`:1. **Sync to deployment targets**: ```bash ./sync-templates.sh ``` This syncs to `docker/authentik/custom-templates/` and `services-api-helm-chart/static/emails/`⚠️ **Never edit** `docker/authentik/custom-templates/` or `services-api-helm-chart/static/emails/` directly - they are auto-synced.## File Naming ConventionTemplates must match Authentik's expected names:- `email_password_reset.html`- `email_account_confirmation.html`- `email_account_exists.html`- Custom stages: Match the stage's template name configuration## Common VariablesMost frequently used:- `{{ user.name }}` - User's display name- `{{ user.email }}` - User's email- `{{ url }}` - Action URL (reset, confirm, etc.)- `{{ expires }}` - Link expiration in hours## Testing ChecklistBefore deployment:- [ ] Business casual tone throughout- [ ] No emojis in headers or content- [ ] All Django variables render correctly- [ ] Button link uses `{{ url }}`- [ ] Fallback text URL included- [ ] Octopize brand colors applied correctly- [ ] Footer includes copyright year- [ ] Template comment at top describes purpose- [ ] No external CSS or JavaScript- [ ] Responsive on mobile preview## Examples from CodebaseReference existing templates in `common/authentik-templates/`:- `email_password_reset.html` - Security-focused with warning box- `email_account_confirmation.html` - Professional welcome message- `email_account_exists.html` - Informative with helpful guidance## Additional Resources- **Variables reference**: [authentik-variables.md](references/authentik-variables.md)- **Color schemes**: [color-schemes.md](references/color-schemes.md)- **Authentik docs**: https://goauthentik.io/docs/flow/stages/email/---> Converted and distributed by [TomeVault](https://tomevault.io/claim/octopize) — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/octopize--avatar-deployment--authentik-email-templates commit 05ebe6a52d

Frequently asked questions

npx skillmds@latest add tomevault-io/authentik-email-templates