Verifying your domain
Before CloudPress hosts mail for a domain, it has to know the domain is yours. For most orders that means publishing one DNS TXT record and clicking a button. You only do this once per domain. The record only proves ownership, so you can remove it once your domain is verified.
Before you start
- A paid Mailspace order. See Ordering a Mailspace.
- The ability to add a DNS record for the domain, either here (if we run its DNS) or at wherever its DNS is hosted.
- A workspace role that can make changes.
When you'll be asked to verify
| The domain is… | What happens |
|---|---|
| Registered with us | Verified at once; the Mailspace goes straight to being created |
| Registered elsewhere, DNS hosted with us | You add the TXT record here |
| Registered and hosted elsewhere | You add the TXT record at your DNS provider |
Steps
-
Open the verification page. In the workspace sidebar, choose Mailspace. The new Mailspace's row shows an Awaiting verification badge. Click Verify domain.
-
Copy the verification record. The Verification record card shows one row:
Column What it holds Type TXTName / Host _mailspace-verify, with the full name below it, for example_mailspace-verify.example.comValue A long token, unique to this Mailspace Use Copy value rather than retyping the token.
-
Add the record where your DNS is hosted.
- If we host the domain's DNS, add it in the DNS editor. See
Managing DNS. Choose TXT, enter
_mailspace-verifyas the Record Name, and paste the token into Content. - If your DNS is elsewhere, add a TXT record at the full name shown on the page,
with the token as its value. Some providers want the full name and others only the
_mailspace-verifypart, so check your provider's documentation if unsure.
- If we host the domain's DNS, add it in the DNS editor. See
Managing DNS. Choose TXT, enter
-
Click Verify domain now. If the record is visible, the page confirms the domain is verified. If not, wait a few minutes for DNS changes to take effect and try again. We also re-check automatically, so you can leave the page and come back later. The automatic re-check stops after a mailspace has been unverified for a long time. If you publish the record later, click Verify domain now again.
-
Wait for the Mailspace to be created. The page updates by itself and usually finishes in under a minute. If something goes wrong, the status reads Setup paused; click Retry setup.
-
Continue to the Mailspace. When the page reads All done, click Continue to your mailspace account. The row in the Mailspace list now offers Manage.
If it still won't verify
- Check the host, not just the value. The record has to sit at the full name shown on the
page. If your DNS editor adds the domain for you, enter only
_mailspace-verify; if it wants the whole host, enter_mailspace-verify.example.com. - Give it a few minutes. Last checked on the page shows when we last looked.
- Adding a second domain later works the same way. A domain you add to an existing Mailspace that we can't confirm you own gets its own Verification record card and Verify domain now button.
Changed your mind
While a Mailspace is waiting to be set up, the verification page offers Cancel order. Confirm, and anything you paid comes back as workspace credit. This can't be undone. Once setup has finished, delete the Mailspace instead. See Deleting and restoring a Mailspace.
Next steps
- Finish the domain's mail DNS records (MX, SPF, DKIM and DMARC). If we run the domain's DNS, see Managing DNS; otherwise add them at your DNS provider.
- Create your mailboxes. See Managing mailboxes.
- Set up your mail app. See Connecting a mail client.
- To read the verification record from the API, see Mailspace.