Skip to main content

Mail Forwarding

On staging and other non-production environments, mail forwarding redirects every outgoing email to a single inbox. This lets you test flows that send mail — magic links, receipts, notifications — against real addresses without the risk of emailing actual members.

Never runs in production

Mail forwarding is ignored entirely in production. Enabling it has no effect on a production instance, so outgoing mail is always delivered normally there.

Configuration

Open Global Settings → Mail (super-admin only) to configure forwarding:

FieldDescription
Forward all outgoing mailWhen enabled, every outgoing email is redirected to the forward address below.
Forward toThe single inbox that captured mail is sent to (for example, a shared QA inbox or a Slack inbound address).
Bypass addressesOne email per line. Messages addressed only to these recipients are delivered normally instead of forwarded.

Save the page to apply the changes.

How forwarding works

When forwarding is enabled on a non-production environment, each outgoing message is checked against the bypass list:

  • If every recipient (To, Cc, and Bcc) matches a bypass entry, the message is delivered untouched.
  • Otherwise the whole message is redirected to the forward address, and its Cc and Bcc recipients are cleared. The original recipients are preserved in an X-Original-To header so you can see who the mail was meant for.

Bypass matching

Bypass entries can be literal addresses or * wildcard patterns:

[email protected]
*@example.com
qa-*@example.com

Both the message recipients and the bypass entries are normalized before they are compared — addresses are lowercased and + sub-address tags are stripped (so [email protected] matches a bypass entry of [email protected]).