Adding a domain to a site
Connect your own domain to a CloudPress site so visitors reach it over HTTPS at your domain instead of the temporary CloudPress URL. CloudPress issues the SSL certificate for you. Domains you bought in the same cart as the site are connected automatically.
Before you start
- A site that has finished setting up. Trial sites can't add domains until onboarding is finished.
- A domain you can edit DNS or nameservers for, or one you want to register or transfer through the wizard. See Purchasing a domain.
- A workspace role that can edit the site.
Steps
-
In the left sidebar, open My Sites, select the site, then choose Domains in the site's sidebar.
-
Click Add Domain. A three-step wizard opens: Domain → Connect → Verify.
-
Type the domain, apex (
example.com) or subdomain (shop.example.com), in the Domain field and click Continue. A domain already connected to another site in the workspace is refused. -
Choose what to do, depending on what CloudPress finds:
You see What to do Ready to connect CloudPress already hosts DNS for the domain. Click Connect domain. If the zone has records at that name they are listed, and the button reads Replace & connect. Available to register Click Register this domain and check out. CloudPress does the rest once the order completes. For a premium name, click Contact support. Registered with another provider Click Transfer this domain to move billing, DNS and renewals to CloudPress (you need an authorization/EPP code from your current registrar, and it takes a few days). A transfer isn't connected automatically; connect it with these steps once it lands. Or click Connect without transferring to keep it where it is. Any other message Follow the connect options shown. Click Retry if offered. -
If you chose to connect, pick how at How do you want to connect it?, then click Connect domain:
- Point your nameservers. Change the domain's nameservers at your registrar to the ones shown. CloudPress then manages the DNS zone and SSL. Recommended for an apex domain.
- Add a CNAME record. Keep your DNS where it is and add the CNAME record shown. Recommended for a subdomain.
Warning
If your DNS is on Cloudflare, set the record to DNS only (grey cloud). With the orange-cloud proxy on, no certificate can be issued.
-
You land on the domain's page, which updates by itself. CloudPress emails you when the domain is live.
DNS changes can take up to 48 hours to take effect.
To add a domain over the API, see Domains.
Following progress on the domain's page
In Your domains, click a domain to see its status. Check now re-checks right away if you don't want to wait.
| Status | What it means | What to do |
|---|---|---|
| Added | The domain is attached and being prepared. | Nothing. |
| Pointing DNS | Waiting for your DNS change. | Make the nameserver or CNAME change from step 5. |
| Verifying | Checking that traffic reaches us. | Nothing. |
| Securing SSL | The certificate is being issued. | Nothing. |
| Live | HTTPS is active. | Nothing. |
| Problem | The domain can't be reached. | Work through the What to check list on the page, then click Check again now. |
| Action needed | CloudPress needs something from you. | Follow the page. See below. |
| DNS issue | The domain no longer points at us. | Point it at the target shown under Point it here, then click Check again now. |
If a CAA record on your domain blocks the certificate, add our certificate authority to it or remove it.
Pre-issuing an SSL certificate (optional)
To get a valid certificate before you switch traffic to your domain, avoiding any HTTPS gap:
-
On the domain's page, click Pre-issue SSL certificate (advanced).
-
Under Add this DNS record, copy the TXT record's Type, Name and Value and add it at your DNS provider.
-
Click I've added it — verify now. If it can't be verified yet, try again once DNS has updated. CloudPress emails you when it is verified.
Managing the domain afterward
The domain's page has these actions in its header:
- Manage DNS opens the domain's DNS records, when CloudPress hosts its zone. See Managing DNS.
- Set as primary makes an alias the site's primary domain.
- Remove domain detaches it from the site. If you remove the primary domain, the site falls back to its CloudPress system address, so promote a replacement first.
- Visit opens the live site in a new tab.
Next steps
- Point or edit your records in Managing DNS
- Don't own the domain yet? Purchase a domain
- Automate it with the Domains API