Custom domains

By configuring a custom domain for your project, your project can serve documentation from a domain you control, for instance docs.example.com. This is great for maintaining a consistent brand for your product and its documentation.

Default subdomains

Without a custom domain configured, your project’s documentation is served from a Read the Docs domain using a unique subdomain for your project:

  • <project name>.readthedocs.io for Read the Docs Community.

  • <organization name>-<project name>.readthedocs-hosted.com for Read the Docs for Business. The addition of the organization name allows multiple organizations to have projects with the same name.

See also

How to manage custom domains

How to create and manage custom domains for your project.

Features

Automatic SSL

SSL certificates are automatically issued through Cloudflare for every custom domain. No extra set up is required beyond configuring your project’s custom domain.

CDN caching

Response caching is provided through a CDN for all documentation projects, including projects using a custom domain. CDN caching improves page response time for your documentation’s users, and the CDN edge network provides low latency response times regardless of location.

Multiple domains

Projects can be configured to be served from multiple domains, which always includes the project’s default subdomain. Only one domain can be configured as the canonical domain however, and any requests to non-canonical domains and subdomains will redirect to the canonical domain.

Canonical domains

The canonical domain configures the primary domain the documentation will serve from, and also sets the domain search engines use for search results when hosting from multiple domains. Projects can only have one canonical domain, which is the project’s default subdomain if no other canonical domain is defined.

See also

Canonical URLs

How canonical domains affect your project’s canonical URL, and why canonical URLs are important.

Subprojects

How to share a custom domain between multiple projects.