# 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. - Skill: `tomevault-io/authentik-email-templates` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/authentik-email-templates` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/authentik-email-templates/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/authentik-email-templates --- # Authentik Email Templates Create professional, branded email templates for Authentik authentication flows. ## Quick Start 1. **Choose a base template** from `assets/` matching your email type 2. **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 purpose 4. **Test variables** using [authentik-variables.md](references/authentik-variables.md) 5. **Save to correct location**: `common/authentik-templates/` ## Template Structure All Authentik email templates follow this pattern per official documentation: ```html {# Django comment describing template purpose #} {% load i18n %} {# Optional: {% load humanize %} for time formatting #}

{% trans 'Header Title' %}

{% blocktrans with username=user.username %}

Hello {{ username }},

{% endblocktrans %}
``` ## Critical Requirements Per 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 variable 3. **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' %}` tags 6. **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 ```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 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
Action Text

Or copy and paste this link into your browser:

{{ url }}

``` Always provide both button and plain text URL for accessibility. ## Deployment Workflow After 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 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](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.