Custom Domain Setup

With the Pro plan, you can point your own domain at your Docsio documentation site. SSL is provisioned automatically.

Requirements

Before setting up a custom domain, you need:

• An active Pro subscription
• At least one successful publish of your project
• Access to your domain's DNS settings (at your registrar or DNS provider)

Step-by-Step Setup

1. Open Project Settings

Navigate to your project and click the Settings icon in the editor toolbar. Scroll down to the Custom Domain section.

2. Enter Your Domain

Type your desired domain in the input field. This is typically a subdomain like:

• docs.yourcompany.com
• help.yourproduct.io
• developer.yourbrand.com

3. Add the DNS Record

Go to your DNS provider and add the following record:

Type	Name	Value
CNAME	docs (or your subdomain)	yourproject.docs.docsio.co

Replace yourproject with your actual project slug, and docs with whatever subdomain you entered.

Example

If your project slug is acme and you want your docs at docs.acme.com, the DNS record would be:

Type	Name	Value
CNAME	docs	acme.docs.docsio.co

4. Wait for DNS Propagation

DNS changes can take time to propagate across the internet. In most cases this is 1 to 5 minutes, but it can take up to 48 hours depending on your DNS provider and TTL settings.

5. Verify DNS

Back in Project Settings, click Verify DNS. Docsio checks whether your CNAME record is correctly configured and pointing to the right destination.

• If verification succeeds, you see a confirmation message and the Connect Domain button becomes available.
• If verification fails, wait a few more minutes and try again.

warning

DNS changes can take time to propagate. If verification fails, wait a few minutes and try again. Do not change the DNS record -- just wait for propagation to complete.

6. Connect the Domain

Once DNS is verified, click Connect Domain. Docsio configures the hosting to serve your site on the custom domain and provisions an SSL certificate.

7. Republish Your Site

After connecting the domain, republish your project. This updates the canonical URLs and metadata throughout your site to reference the new domain.

tip

SSL provisioning happens automatically after you connect the domain. It may take a few minutes for the certificate to be issued. During this time, visitors may see a security warning -- this resolves on its own.

Removing a Custom Domain

To disconnect a custom domain, go to Project Settings > Custom Domain and click Remove. The site reverts to your Docsio subdomain (yourproject.docs.docsio.co). You should also remove the CNAME record from your DNS provider.

Troubleshooting

Issue	Solution
DNS verification keeps failing	Wait longer for propagation. Some providers take up to 48 hours.
Site shows security warning after connecting	SSL is still provisioning. Wait a few minutes.
Domain works but shows old content	Republish your project to update all URLs and metadata.
"Publish your project first" message	You need at least one successful publish before custom domains can be configured.