Custom domains

Every workspace starts with a working your-team.knobs.io subdomain — mail in and out, zero setup. Connecting a custom domain puts your team’s addresses on your own name: you@yourcompany.com instead of you@yourcompany.knobs.io.

Domain management lives in Settings → Domains (owners and admins). A workspace has its subdomain plus one custom domain.

Add your domain

1. Open Settings → Domains and choose Add domain.
2. Enter the domain (e.g. yourcompany.com).
3. Knobs shows the DNS records to create at your DNS provider. Each has a copy button and a live verified / pending status:

Record	Purpose
_knobs-verify TXT	Proves you own the domain
MX	Routes the domain’s inbound mail to Knobs
DKIM (3 CNAMEs)	Cryptographically signs your outbound mail
SPF (TXT)	Authorizes Knobs to send for your domain
DMARC (TXT)	Tells receivers how to treat mail that fails checks

4. Add the records at your DNS provider, then click Verify. Knobs also keeps re-checking automatically in the background, so you can close the dialog and come back — statuses flip to verified as your DNS propagates.

The domain is verified once the ownership TXT, DKIM, and MX records pass. SPF and DMARC are strongly recommended for deliverability and show as warnings until they pass, but don’t block verification.

Note

DNS propagation can take anywhere from minutes to a few hours depending on your provider and TTLs. Partial progress is normal — records verify independently.

What happens when it verifies

• Everyone gets an address. A mailbox on the new domain is provisioned automatically for every member, reusing each person’s existing local part (jesse@acme.knobs.io → jesse@acme.com).
• You can make it the default. Switch the workspace’s default domain to the custom domain so new members and workspace addresses use it first. Existing subdomain addresses keep working.
• Sign-in accepts addresses on any verified domain — see Create your account.

During onboarding, or later

The same flow appears inside onboarding when you choose a custom domain at sign-up — with an explicit skip, so sign-up always completes on the subdomain and the domain can be finished later. Nothing is lost by skipping.

Undelivered mail

The Domains section also carries the admin-only Undelivered view: mail sent to an address on your domain that doesn’t exist yet (a typo, or a person who hasn’t been invited) is held rather than lost. From Undelivered you can create the missing address or deliver a held message anyway. See Mailboxes & aliases.

Removing a domain

Removing the custom domain disables its mailboxes (mail history is preserved) and frees the domain. The your-team.knobs.io subdomain is permanent and can’t be removed.