Custom domain
Serve your manuals from your own address, such as help.yourcompany.com, instead of sonat.com.
Only an Owner or Admin can set up a custom domain.
When to use a custom domain
- Your brand, not ours: readers see your company's address in the browser and in search results.
- Links that last: if you ever move platforms, the address you've shared stays yours.
- Free HTTPS: Sonat issues and renews the SSL certificate for you.
Before you begin
- You need access to your domain's DNS settings at your registrar or DNS provider (GoDaddy, Namecheap, Cloudflare and so on), or someone in IT who has it.
- Decide on the address. A subdomain such as
docs.yourcompany.comis the most common choice. You can also use a root domain such asyourcompany-docs.comif nothing else runs on it. - One custom domain applies to your whole organization: every published document moves to it.
Connect your domain
1. Enter the domain
- In the sidebar, select Organization Settings and open the Custom Domain tab.
- In the first box, Connect a domain, type the address without
https://, for exampledocs.yourcompany.com. - Select Next.

2. Add the DNS record
The second box, Configure your DNS, shows the record to add. Which record depends on the address you entered:
| Your address | Record type | Name / Host | Value / Target |
|---|---|---|---|
A subdomain, such as docs.yourcompany.com | CNAME | The subdomain part, for example docs | hosting.sonat.com |
A root domain, such as yourcompany-docs.com | A | @ | 35.196.253.75 |
- Select the copy icon next to the value Sonat shows. Use the value on screen if it differs from the table.
- In your DNS provider, create the record with the type, name and value above. Leave TTL at its default.
- Save the record, then come back to Sonat and select Next. Sonat checks that your domain reaches it.
3. Save
- When the check passes, the third box says You're ready to go! and “Your domain is now properly configured.”
- Select Save. The page reloads with your new address in place.
- Open your domain in a new tab. It can take a few minutes before it loads with HTTPS.
Where to find the DNS settings
| Provider | Where the record goes |
|---|---|
| GoDaddy | My Products › Domain › DNS › Add New Record |
| Namecheap | Domain List › Manage › Advanced DNS › Add New Record |
| Cloudflare | Your site › DNS › Records › Add record (DNS only) |
| Google Cloud DNS | Network services › Cloud DNS › your zone › Add standard |
Remove or change the domain
- Open Organization Settings › Custom Domain.
- In the Connect a domain box, select Delete to go back to sonat.com. Or type a new address and go through the steps again.
If something goes wrong
“We couldn't find your domain pointing at Sonat.”
Sonat can't reach your domain yet. Check that the record's name is only the subdomain (docs, not docs.yourcompany.com on providers that add the domain for you), that the value matches exactly, and that no other record uses the same name. Wait a few minutes and select Refresh.
“Invalid custom domain”
Remove https://, any path such as /docs, and spaces. Enter only the host name. Sonat accepts up to three dots, so help.docs.yourcompany.com works but a deeper address doesn't.
The browser shows a certificate warning
The certificate is issued the first time someone opens the domain after DNS is in place, and can take a few minutes. If it persists, check whether your domain has a CAA record. If it does, add one that allows letsencrypt.org.
Old sonat.com links
Readers who open an old sonat.com link see “This content has moved” with a Visit on new domain button. Update the links on your website and in your product to the new address.
Related
- Publish your first manual
- Brand your help center
- Make a document private: limit who can read your manuals.
- Search engine optimization