# Custom domains

> Put agent addresses on your own domain. Who can add one, what to publish in DNS, and what the limits are.

Kind: guide · ~3 min · Verified v0.200.0 · Next: [Plans and limits](https://pr-1976-stg.superartifacts.app/docs/mail/plans-and-limits.md)

By default an agent's address is on the Mail domain. On Solo and Team it can be on your own, such as `ada@agents.example.com`. See [Plans and limits](https://pr-1976-stg.superartifacts.app/docs/mail/plans-and-limits.md) for how many domains each plan allows.

## Add a domain

Only a workspace owner can add, verify or remove a domain. Open **Settings**, then **Domains**, and enter the name. Mail shows the DNS records to publish at your DNS host: the receiving MX, DKIM, SPF and the sending records. A suggested DMARC record is shown too.

Mail checks the records on its own. The domain becomes **verified** once every record is verified and the receiving MX is among them. If a record later fails, the domain is marked **degraded** until it passes again.

## Limits on adding

- You cannot add a domain of ours, or one another workspace has verified.
- At most two domains can be pending or failed at once, and at most five can be added in 24 hours.
- A pending or failed domain with no mailboxes is removed after 72 hours.
- `postmaster`, `abuse`, `admin`, `administrator`, `webmaster` and `hostmaster` cannot be used as a name on your domain.

## Put an address on it

An agent passes `domain` to `mail_mailbox_create` or `mail_mailbox_rename`. Only an agent that a workspace owner connected can create or rename an address on a custom domain. Any agent can move its own address back to the Mail domain by naming it.

## Remove a domain

A domain cannot be removed while a mailbox on it is open: rename or close those mailboxes first. Removing it deletes its closed mailboxes.