Email Templates

Configure transactional emails sent by Authority.

Email Types

Authority sends these transactional emails:

Email
Trigger

Welcome

New user registration

Email Verification

Verify email address

Password Reset

Reset password request

MFA Enabled

Two-factor authentication enabled

New Login

Login from new device

Template Location

public/templates/emails/
├── base.html           # Base layout
├── welcome.html        # Welcome email
├── verification.html   # Email verification
├── password-reset.html # Password reset
├── mfa-enabled.html    # MFA confirmation
└── new-login.html      # New login alert

Template Structure

Base Template

emails/base.html:

Password Reset Email

emails/password-reset.html:

Welcome Email

emails/welcome.html:

Available Variables

All Emails

Variable
Description

base_url

Authority base URL

app_name

Application name

company_address

Company address

user.name

User's name

user.email

User's email

Password Reset

Variable
Description

reset_url

Password reset link

expiry_minutes

Link expiry time

Email Verification

Variable
Description

verification_url

Verification link

expiry_hours

Link expiry time

New Login Alert

Variable
Description

device

Device description

location

Approximate location

ip_address

Client IP

login_time

Login timestamp

Configuration

SMTP Settings

Email Settings

Testing Emails

Preview in Browser

Send Test Email

HTML Email Best Practices

circle-info

Email HTML is limited:

  • Use inline CSS

  • Use tables for layout

  • Avoid JavaScript

  • Test across email clients

Compatible Styles

Localization

Multiple Languages

Configure default locale:

Troubleshooting

Emails Not Sending

  • Check SMTP configuration

  • Verify credentials

  • Check spam filters

  • Review server logs

Broken Layout

  • Use inline CSS

  • Test with email preview tools

  • Check image URLs are absolute

Images Not Loading

  • Use absolute URLs

  • Host images on accessible server

  • Check HTTPS requirements

Next Steps

Last updated

Was this helpful?