Custom Domain
Host your docs on your own domain, a seamless extension of your brand. You can set this at two levels.
Workspace domain
One domain for your whole workspace. Every project is published under it automatically, with the project slug as the path. Set it once in the Developer Portal settings.
Project domain
A dedicated domain for a single project, for when one project needs its own branded URL.
Set the workspace domain once and it covers everything. Add a project domain only when you want a specific project served somewhere of its own.
Workspace domain
The workspace domain is configured in the Developer Portal settings and applies across your whole workspace. Once it is set, every project is automatically published under it, using the project slug as the path. New projects inherit it with no extra setup.
For example, with a workspace domain of docs.theneo.io, a project whose slug is test is automatically served at docs.theneo.io/test.
1
Open Developer Portal settings
Go to app.theneo.io/developers-hub/settings.
2
Enter your workspace domain
Specify a domain that aligns with your brand, e.g. docs.yourdomain.com.
3
Configure DNS
In your domain provider’s control panel, add a CNAME record pointing your domain to custom.theneo.io.
4
Activate
Save the settings and wait for DNS to propagate before going live. Every project in the workspace is then reachable under your domain.
Project domain
Give a single project its own dedicated domain when it needs a branded URL separate from the workspace path. A project domain takes precedence for that project; every other project stays under the workspace domain.
1
Open Project Settings
Log in, open the project’s settings, and select the Custom Domain section.
2
Enter your domain
Specify the domain you want, e.g. docs.yourdomain.com.
3
Configure DNS
In your domain provider’s control panel, add a CNAME record pointing your domain to Theneo’s hosting environment, typically custom.theneo.io. For example:
developers.example.com. 3600 IN CNAME custom.theneo.io4
Finalize in Theneo
Return to Theneo and save your custom domain configuration. Once DNS propagates, the project is reachable at its own domain.
Good to know
- DNS propagation: DNS changes can take up to 48 hours to propagate fully.
- SSL certificates: Theneo automatically generates SSL certificates for custom domains, so connections are secure.
On this page
- Custom Domain