Email Custom Domains

Overview

By default, Wristband sends transactional emails using a Wristband-managed sending domain. Email custom domains allow you to send these messages from your own domain, providing a consistent branded experience across authentication workflows such as user invitations, email verification, signup, and password reset.

Wristband supports email custom domains at both the application and tenant levels:

• Application-Level Email Custom Domains: Configure a custom email domain for transactional emails sent by your application.
• Tenant-Level Email Custom Domains: Configure a dedicated email domain for an individual tenant, allowing customers to receive transactional emails from a sender address associated with their organization.

To use a custom email domain, you must first configure the required DNS records and verify domain ownership. Once verified, you can update the Email Branding sender details to use an email address with the custom domain.

Application-Level Email Custom Domains

Application-level email custom domains allow you to configure a default sending domain for transactional emails across your application.

Configuring an Application Email Custom Domain

To configure an application-level email custom domain, follow these steps:

1. Create a Custom Domain: From the Application View in the Wristband Dashboard, navigate to Custom Domains → Email Domains and create a new custom email domain.

2. Configure DNS Records: After creating the domain, Wristband generates the DNS records required to verify your domain. Copy these records and add them to your DNS provider.

3. Verify the Domain: Once the DNS records are configured, click the verification button in the Dashboard to validate your DNS configuration. If verification is unsuccessful, you can retry the process. The domain's status will automatically update once verification is complete.

4. Update Email Branding: Once your custom email domain is verified, navigate to Branding → Emails in the Application View. Under Sender Details, update the From Address to use an email address associated with your custom domain.

After saving your email branding configuration, Wristband uses the updated sender address for subsequent transactional emails.

Tenant-Level Email Custom Domains

Tenant-level email custom domains allow individual tenants to send transactional emails using their own domains instead of the application's default sending domain.

This is particularly useful for B2B applications where customers require authentication emails to originate from their own corporate domains.

Configuring a Tenant Email Custom Domain

To configure a tenant-level email custom domain:

1. Select a Tenant: From the Application View in the Wristband Dashboard, select the tenant you want to configure using the tenant dropdown in the side navigation menu.

2. Create a Custom Domain: Navigate to Custom Domains → Email Domains in the Tenant View and create a new custom email domain.

3. Configure DNS Records: Copy the DNS records generated by Wristband and add them to your DNS provider.

4. Verify the Domain: Trigger verification in the Dashboard to validate the DNS configuration. You can retry verification if necessary.

5. Update Tenant Email Branding: Navigate to Branding → Emails, select the Edit Tenant Config tab, and enable the tenant override toggle. Under Sender Details, update the From Address to use an address associated with your verified custom email domain, then save your changes.

Once configured, transactional emails associated with that tenant use its custom sender address, while other tenants continue using their respective email branding configurations.

For more information about tenant-specific email branding and its exceptions, see the Email Branding documentation.