Tech.euDisplay.dev raises €470K to power document collaboration for AI agentsDisplay.dev raises €470KRead coverage
Skip to content

Company email domains

Add a company email domain, verify DNS, and transfer an eligible domain between organizations.

On this page

Organization Owners can add company email domains that identify members of the organization.

Additional email domains require Pro with the email domains add-on, or Enterprise. See Plans & features for the plan comparison.

Add and verify a domain

Open Settings → Email Domains, enter the domain, and add it. Display.dev gives you a TXT record:

  1. Add the TXT record at your DNS provider.
  2. Wait for DNS changes to become available.
  3. Select Verify.

The pending domain does not change sign-in or membership. After verification, people with a verified email address on that exact domain can join the organization as Members.

You can use the same workflow from the CLI:

bash
dsp email-domains add <domain>
dsp email-domains verify <domain>
dsp email-domains list
dsp email-domains remove <domain>

Agents can use add_email_domain, verify_email_domain, list_email_domains, and remove_email_domain.

Transfer a domain already in use

Adding a domain that is connected to another Display.dev organization starts a transfer request. Publish the fresh TXT record and verify it. The earlier verification record does not satisfy the new request.

After DNS verification, a target Owner can review the people who will move in Settings → Email Domains. Final confirmation is available only in the dashboard. CLI commands and agent tools can start, verify, inspect, or cancel the request, but they cannot complete it.

The source Owner does not approve the transfer. Control of the DNS record and confirmation by a current target Owner provide the required authority.

Transfer requests expire after seven days. If a request expires, add the domain again to create a fresh request-specific TXT record. To cancel a pending, ready, or support-required request from the CLI, run dsp email-domains remove <domain>.

What an eligible transfer changes

An automatic transfer is available only when the other organization is an empty Free organization created for the same email domain. It must have no published content, invitations, credentials, billing, integrations, or unrelated members.

When the target Owner confirms:

  • the verified domain moves to the target organization;
  • people from the other organization join as Members, unless they already have a role in the target;
  • source Owner and Admin roles do not move;
  • the empty organization retires; and
  • every affected person must sign in again.

The review lists the affected email addresses and the role each person will have before the Owner confirms.

When support is required

Display.dev stops the automatic transfer when the other organization contains content, billing, credentials, integrations, unrelated people, or other configuration. The page does not expose those details.

Contact support from the blocked request. An Owner can also cancel the request, resolve the source state with support, and add the domain again. Transfers cannot be reversed from Email Domains settings after completion.

See Roles & administration for who can manage domains.

Was this page helpful?