Customize the emails your users receive

Your project sends five kinds of email on behalf of your app. Each goes out as a designed HTML email with a plain-text copy. You can keep the defaults or write your own wording.

Edit an email

1. Open Authentication and choose Settings.
2. Open the Emails tab.
3. In the Email list, pick one of: Email verification, Magic link, One-time code, Password reset or Password changed notice.
4. Edit the Subject and Message. Leave them blank to use the designed default.
5. Choose Save changes.

A preview below the form updates as you type, so you can see exactly what users will get.

Make it yours

• Sender name: the name people see in their inbox. It defaults to your project name and can be up to 60 characters.
• Button colour: a hex colour such as #0f766e. It must be dark enough for white button text. If it is too light, the save is refused with a message asking for a darker colour.
• Link path: for emails that contain a link (verification, magic link and password reset), the path added to your Site URL. You can use {token}, {type} and {email} in it, for example /auth/confirm?token={token}.

Placeholders

Insert placeholders in the subject or message by choosing one of the Insert chips. They are written with double curly braces.

Placeholder	Available in
{{email}}, {{project_name}}	Every email
{{link}}, {{token}}, {{link_or_token}}	Email verification, Magic link, Password reset
{{code}}	One-time code
{{expires_in}} (for example "10 minutes")	Verification, Magic link, One-time code, Password reset
{{time}}	Password changed notice

{{link_or_token}} is the link when your project has a Site URL, and the token otherwise, so one template works either way. A placeholder that is not in the list for that email, or a stray {{, is rejected when you save.

Limits: the subject must be a single line of at most 200 characters, and the message at most 5000 characters.

Check it in a real inbox

Choose Email me this one to send the saved version of the selected email to yourself. The code or link in a test email is a sample and will not work. Use Use the default wording to clear your changes for that email.

Send from your own domain

By default these emails come from PGB's address. To send them from [email protected] instead, see Send authentication emails from your own domain.

Good to know

• Nothing in a template is ever executed. Placeholders are only substituted, and values are escaped in the HTML version.
• Email wording is per project. If you run several projects, set each one up.
• If your account's email sending is not approved for production, sign-in emails may only reach approved addresses. See Request approval to send email.