---
title: "Custom domain"
url: "/help/buuk/custom-domain"
updated: "2026-11-13T18:45:42.873Z"
---
# Custom domain

By default your help center lives at `/help/your-slug` on a Buuk URL. A custom domain serves it from your own hostname — `docs.yourproduct.com` — so the docs share your product's brand, links, and search results instead of trusting a foreign domain.

> [!NOTE]
> Custom domains are a Growth capability. Starter stays on the Buuk-subdomain URL. See [Plans and billing](./plans-and-billing).

## Add the hostname

1. Open **Settings → Domains**.
2. In **Add a domain**, enter a hostname such as `docs.yourcompany.com` and add it.
3. The page then shows the exact DNS records for that hostname.
4. Create the records where you manage DNS, then select **Recheck now**.

![Settings → Domains: add a hostname, then copy the DNS records it shows.](/api/media/assets/450d773f-326f-44cd-a809-b3ae5e61a9fd)

## Point your DNS

The dashboard's **Point your DNS** panel lists the records for each hostname you added, with a copy button for every value. Subdomains get a CNAME; bare domains get an A record.

| Type | Name | Value |
| --- | --- | --- |
| CNAME | _your subdomain, e.g. docs.yourcompany.com_ | _the target shown in the panel_ |
| A | @ | _the address shown in the panel_ |
| TXT | `_buuk-verify.<hostname>` | _the verification token from the panel_ |

Apex domains usually need the A record. If your DNS provider does not support CNAME-style records at the apex, use their ALIAS or ANAME record pointed at the CNAME target instead.

> [!WARNING]
> If you use Cloudflare, set the CNAME record to DNS only (grey cloud) during setup so verification is not proxied.

## Verification and activation

A new domain starts Pending. The TXT record proves you control the hostname; propagation can take up to 24–48 hours, though it is usually just minutes.

Select **Recheck now** once the records have propagated. When DNS resolves, the status moves to Verified and the panel says DNS looks good — mark the domain active when you are ready. Once a domain is Active, visitors on it see your published help center at the root URL.

You can connect more than one hostname and set a primary with the star. The default `/help` URL keeps working, so links already in circulation do not break.

**DNS has not propagated yet**

Verification reads your DNS live. Right after editing records, most providers answer within minutes; some take hours. Wait, then select **Recheck now** again instead of re-adding the domain.

**Verification stays stuck**

Check that the TXT record name is `_buuk-verify.<hostname>` and that the value matches the token in the panel exactly — a truncated token or stray quotes both fail. If the subdomain record is right and verification still fails, the token can also be read at the bare hostname, so check that record too. A proxied CNAME (orange cloud) will not verify; set it to DNS only first.

**Keep the /help URL working**

The `/help/your-slug` URL keeps serving your help center during and after setup, so nothing expires while DNS settles. Keep it as the fallback until the new domain is Active.

> [!TIP]
> Add the records for the TXT token before switching marketing links over. DNS proof the dashboard can re-check is the whole gate — once Verified, the domain rarely needs attention again.

## Related

- [**Branding**](./branding-and-custom-domain) — logo, colors, and where the domain controls live.
- [**Publish your help center**](./publish-your-help-center) — how the help center goes live.
- [**Plans and billing**](./plans-and-billing) — where the custom domain capability sits.
- [**SSO**](./sso) — the other feature that asks for a DNS record.