Use a custom domain when readers should access your docs from your own domain,
such as docs.example.com.
Custom domains are available on Growth and Pro plans. Only organization owners can add or remove a custom domain.
Supported domain patterns
| Pattern | Example | How Radiant handles it |
|---|---|---|
| Subdomain | docs.example.com | Radiant provides a CNAME target and manages SSL readiness |
| Public docs URL with path | example.com/docs | Radiant stores the public URL for display and routing context |
Root domains such as example.com are not supported yet for Radiant-managed
custom domains. Use a subdomain such as docs.example.com.
Add a custom domain
Open the domain settings
In the Radiant dashboard, open the domain settings for your docs project.
Enter a subdomain
Enter the docs subdomain you want readers to use, such as
docs.example.com.
Add the CNAME record
Radiant shows the CNAME record to add at your DNS provider. Add that record for the subdomain.
Return to Radiant
Go back to the dashboard and check the domain status. DNS and certificate readiness can take time to propagate.
Domain status
| Status | Meaning |
|---|---|
| Pending | Radiant is waiting for DNS or certificate readiness |
| Active | The custom domain is ready for readers |
| Failed | Radiant could not activate the domain |
When the domain becomes Active, readers can use the custom domain to access the docs site.
Change or remove a domain
Organization owners can remove the current custom domain from the dashboard. After removal, the docs site continues to be available from its Radiant-hosted URL unless the project is otherwise unpublished or deleted.
To switch domains, remove the current domain and add the new one.