Custom domain for your docs (and why your customers notice)

The URL of your documentation is the smallest piece of branding you have — and the one customers see most often. Every time a developer copies a link from your docs into a Slack thread, every time a support agent shares a tutorial, every time someone Googles for an integration guide, your URL is the first impression.

If that URL is yourcompany.gitbook.io or yourcompany.mintlify.dev or anything similar, you are advertising the docs platform, not the product. Most teams move to a custom domain (docs.yourcompany.com) within the first few weeks of going live. Here is why and how.

Five reasons a custom domain matters

1. Trust

When customers click a link to docs.yourcompany.com, they trust it as official. When they click a link to yourcompany.thirdpartyplatform.io, they hesitate — “is this a real docs page or a spoof?“.

2. SEO

Search engines treat content on your domain as part of your domain’s authority. Docs on a third-party domain build that domain’s authority, not yours. When you eventually move to a custom domain, you lose the SEO equity you built up.

3. Email and link sharing

Any time a docs URL ends up in an email, customers’ spam filters score it. A *.yourcompany.com link clears spam checks more cleanly than a yourcompany.someplatform.io link, which can look suspicious to filtering rules.

4. Brand consistency

Your marketing site is yourcompany.com. Your app is app.yourcompany.com. Your status page is status.yourcompany.com. If your docs live at a different domain entirely, the brand breaks. Customers notice.

5. Future-proofing

If you ever switch docs platforms, a custom domain lets you redirect transparently. If your docs live on the platform’s domain, switching means breaking every link customers have ever shared, every blog post that linked to a tutorial, every Stack Overflow answer.

How to set up a custom domain on GitDocAI

GitDocAI supports custom domains on the Essential plan and above. The setup is two pieces: a DNS record you add at your DNS provider, and the platform issuing an SSL certificate automatically.

Step 1 — Add the domain in GitDocAI

In the dashboard, go to Domain → Add custom domain. Type in the domain you want (e.g., docs.yourcompany.com). GitDocAI shows you the DNS record to add.

Step 2 — Add the CNAME at your DNS provider

You will see a record like:

Type:  CNAME
Name:  docs
Value: <something>.gitdoc-publish.app

Add this at your DNS provider (Cloudflare, Route 53, Namecheap, GoDaddy — all work the same way). Save.

Step 3 — Wait for verification (typically 1-10 minutes)

GitDocAI polls DNS for the record. Once it sees your CNAME, it provisions an SSL certificate via Let’s Encrypt automatically.

You will see the status flip from “Pending verification” to “Verified”. At that point, docs.yourcompany.com resolves to your published documentation, served over HTTPS.

Step 4 — Update internal links

Update any internal links (in your app, in your emails, in your marketing site) to point to the new custom domain. Keep the platform URL working too — GitDocAI keeps the original subdomain live as a fallback.

A few gotchas

• Apex / root domains — if you want your docs at yourcompany.com/docs rather than a subdomain, that is a different setup (typically a proxy / reverse proxy from your main site). Subdomains (docs.yourcompany.com) are much simpler.
• SSL certificates — handled automatically by Let’s Encrypt. You do not manage them. They auto-renew.
• Wildcards — if you want multiple docs sites under different paths, set up each as a separate domain.

What changes after the switch

Within 24 hours of cutting over:

• Search engines start indexing the new URL. Google specifically picks it up in the next crawl.
• Customer-shared links now look professional.
• SSO setups that whitelist the docs domain work seamlessly.
• Analytics start attributing docs traffic to your main brand properly.

It is one of the easiest, highest-leverage moves you can make for the perceived quality of your docs. 10 minutes of setup, permanent benefit.

Try GitDocAI — custom domain available on the Essential plan and above.