Custom Domains

A custom domain lets a published project use your own hostname, such as docs.company.com, instead of the default publishing address.

Requirements

The project must be eligible for publishing.
Custom domains require the project to have an active Project Publishing entitlement.
At least one project page must already be live before Site settings are available.
You need access to the domain's DNS settings so you can add verification records.

Add a custom domain

Open the project's Publish page and make sure the project already has at least one live page.
Open Site settings, then find the Domain section.
Enter the hostname you want to use, for example docs.company.com.
Click Verify.

Configure DNS

After you click Verify, the page shows the DNS records you need to add. Add the displayed CNAME record at your DNS provider, using the shown Name and Value.

If ownership or SSL certificate verification records appear, add those records too. Each record includes a copy button so you can copy the exact value into your DNS provider.

Root domains such as company.com cannot use the required CNAME setup. Use a subdomain such as docs.company.com instead.

Verify the domain

Once the DNS records are added, return to Site settings on the Publish page and click the recheck button or Verify again. DNS changes can take time to propagate, so a domain may stay in Pending verification for a while.

Pending verification means the records have not been confirmed yet.
Invalid DNS means the current DNS records do not match the required values.
Verified means the custom domain is ready to serve the published project.

Change or remove a domain

After a domain is verified, use the edit button to change it or the remove button to disconnect it. Removing a custom domain switches the project back to its default publishing address.