Skip to main content

Transactional Emails

Every WordPress site sends transactional email: password resets, registration confirmations, account changes, comment notifications, and similar. By default they are plain text and easy to miss. LetterPress ships a branded template for each event, which you can restyle in the visual builder, preview, and restore at any time.

Where transactional templates live​

Open LetterPress > Templates and switch to the Transactional tab.

The transactional templates tab

Events are grouped in the sidebar:

  • WordPress, core site notifications such as registration, password reset, and comment notices.
  • LetterPress, plugin-generated email such as the signup confirmation.

With LetterPress Pro, each active integration adds its own group here, for example all WooCommerce order emails. See Integrations.

How an event works​

Each event card shows the recipient, for example User or Admin, and a toggle:

  • Toggle on means LetterPress handles this notification with its template.
  • Toggle off falls back to the plain WordPress email.

Every card has three actions:

ActionWhat it does
EditOpens the event's template in the visual Email Builder
PreviewRenders the email with sample data before you change anything
Restore defaultBrings back the original template if your edits went sideways

Because the templates are pre-built, styling a password reset is usually just opening it, swapping the logo and colors, and saving.

Editing an event template​

  1. Open the Transactional tab and click Edit on the event.
  2. The builder loads the template with its event variables in place, for example {{reset_url}} in the button link.
  3. Change the design and copy, then save. The toggle is already on, so the next time the event fires, your design goes out.

Keep the required variable for each event in the content. A password reset template without {{reset_url}} would be useless, so double check the variable list in the template inspector before you finish.

The events LetterPress covers​

EventRecipientTrigger
New User RegistrationUserWelcome email with a secure set-password link
New User RegistrationAdminAdmin notice for each new registration
Password ResetUserPassword reset email, styling only is customized
Password ChangedUserNotice after a password change
Email Address ChangedUserNotice after an email address change
Email Change RequestUserConfirmation link when a user requests an email change
New Comment NotificationAdmin / AuthorNotice when a new comment arrives
Comment ApprovedComment AuthorNotice when a comment is approved
Subscription confirmationUserLetterPress signup confirmation for double opt-in

Event variables come from the site, for example {{user_login}}, {{login_url}}, {{reset_url}}, {{admin_email}}, {{old_email}}, {{new_email}}, {{comment_author}}, {{post_title}}, and {{comment_link}}. The template editor lists the variables available for the selected event and inserts them with a picker.

Building your own plugin? The same registry is open to third party events. See the Transactional Email API to register an event, seed its template, and send it.

Testing​

Use the Preview action on the event card. LetterPress fills the variables with sample values so you can see the finished email before a real event triggers it.

WooCommerce and other plugin emails​

WooCommerce orders, memberships, forms, and LMS notifications follow the same pattern: each integration registers its events in this tab with its own variables, and you restyle them the same way. Integrations are part of LetterPress Pro, see Integrations for the full list.

Next steps​