Emails

Configure SMTP, customize the emails WemX sends, choose email themes and send mass emails.

WemX sends email for account security, orders, payments and subscriptions. Every message is also saved in a log, so customers can read their emails in the client area inbox and staff can see what was sent and whether it was delivered.

Everything lives under Admin → Emails:

PagePurpose
EmailsLog of every email sent, with its status (delivered, failed, read).
ConfigureSMTP connection settings.
TemplatesEdit the subject and text of each automated email.
Mass MailsSend or schedule an announcement to a group of customers.

Configure SMTP

Go to Admin → Emails → Configure and fill in your mail provider's details:

FieldExample
Hostsmtp.postmarkapp.com
Port587
Encryptiontls (port 587) or ssl (port 465)
Username / PasswordYour SMTP credentials
From addressbilling@yourdomain.com
From nameAcme Hosting

Emails are sent by the queue worker. If it isn't running, emails pile up and are never delivered. If emails show as failed in the log, open one to see the error.

Email templates

Every automated email is defined as a template with a subject, a body, an optional button and a set of placeholders. Go to Admin → Emails → Templates to see them, grouped by area.

Templates include:

  • Account: email verification, password reset, account created and activated, new login, password changed, two-factor authentication enabled/disabled, and email address change.
  • Orders: confirmation, activated, suspended, unsuspended, terminated, extended, transferred, renewed with balance, renewal failed (not enough balance), and member invited/accepted.
  • Payments & subscriptions: payment paid, subscription activated, cancelled and inactive.
  • Admin notifications: batches of orders suspended or terminated by the scheduler. These go to the primary admin.
  • Extensions: extensions add their own, for example tickets opened, replied and closed, or "Pterodactyl account created".

Editing a template

Open a template to change it:

  • Enabled: turn a template off to stop sending that email entirely.
  • Subject: supports placeholders.
  • Body: each line becomes a paragraph. Markdown such as **bold** and links works.
  • Button text: only the label can be changed. The URL is generated when the email is sent, for example a link to the order.

Placeholders use double curly braces. The editor lists the ones each template supports:

Subject: Your {{package_name}} order is now active
Body:    Order #{{order_id}} renews at {{cycle}}. Next due date: {{due_date}}.

Your changes are saved as an override of the default text. Click Reset to default to go back to the original text.

Email themes

The design that wraps every email is an email theme. WemX ships with default, dark and client-dark. Choose the default under Settings → Application → Default Email Theme. Mass mails can use a different theme for each campaign. You can install more themes from the Marketplace.

Mass mails

Use mass mails for announcements, maintenance notices or newsletters.

  1. Go to Admin → Emails → Mass Mails → Create.

  2. Write the subject and body (Markdown is supported) and pick an email theme.

  3. Choose an audience:

    AudienceWho receives it
    All customersEvery customer account, excluding staff
    Marketing subscribersCustomers who opted in to marketing emails
    Customers with orders / without ordersCustomers who have, or have never, placed an order
    Customers with a packageCustomers with an order for a package you select
    Customers by order statusCustomers with an order in a given status, for example suspended
    Customers by account statusActive, pending or suspended accounts
    Customers with unpaid invoicesAnyone with an open invoice
    Customers with a subscriptionCustomers with a gateway subscription
    Customers by countryCustomers whose account country matches
  4. Optionally narrow it further with Marketing opt-in only and Verified email only.

  5. Choose Send now or Schedule for a specific date and time.

The scheduler picks up queued mass mails every minute and sends them in the background. Open a mass mail to follow its progress.

Use Marketing opt-in only for anything promotional. Service notices, such as planned maintenance, can usually go to every affected customer.

Sending a single email

To email one customer, open them under Admin → Customers and use Send Email. The message is logged in their email history and appears in their client area inbox.

On this page