Skip to main content
Workspace Custom SMTP lets a workspace send form email notifications through its own SMTP server instead of the instance-wide mailer.
Workspace Custom SMTP is a self-hosted Enterprise feature. Instance-wide email sending with MAIL_* environment variables remains available without an Enterprise license.

​
What this unlocks

Use Workspace Custom SMTP when:
  • A workspace needs emails to come from its own domain.
  • Different workspaces need different SMTP credentials.
  • You want to separate sender reputation or delivery providers by workspace.

​
Before you start

Make sure you have:
  • An active self-hosted Enterprise license with Workspace Custom SMTP enabled
  • Workspace admin access
  • SMTP host, port, encryption, username, password, and sender address

​
Configure Workspace Custom SMTP

1

Open workspace settings

Open the workspace that needs its own sender, then go to Email Settings.
2

Enter SMTP settings

Enter the SMTP host, port, encryption, username, password, and sender address.
3

Save the settings

Save the workspace email settings. Form email notifications from this workspace will use these SMTP credentials when the feature is available.

​
How it relates to instance-wide email

The instance-wide MAIL_* configuration is still the default mailer for your self-hosted instance. Workspace Custom SMTP only overrides email sending for the workspace where it is configured. See Email Setup for the full comparison.