# Zuwiki

## Custom domain

> Category: Plans & Account

---

## Pages

- [Welcome to Zuwiki](https://docs.zuwiki.com/welcome-to-zuwiki)

### Getting started

- [Create your first wiki](https://docs.zuwiki.com/getting-started/create-your-first-wiki)

### Core concepts

- [Wikis, categories, and pages](https://docs.zuwiki.com/core-concepts/wikis-categories-and-pages)
- [Page lifecycle](https://docs.zuwiki.com/core-concepts/page-lifecycle)
- [Page history and restore](https://docs.zuwiki.com/core-concepts/page-history-and-restore)

### Access & Sharing

- [Public vs internal wikis](https://docs.zuwiki.com/access-sharing/public-vs-internal-wikis)
- [Visibility for public wikis](https://docs.zuwiki.com/access-sharing/visibility-and-access)
- [Share links](https://docs.zuwiki.com/access-sharing/share-links)
- [Access grants](https://docs.zuwiki.com/access-sharing/access-grants)
- [Classification and sensitivity](https://docs.zuwiki.com/access-sharing/classification-and-sensitivity)

### Editor guide

- [Markdown basics](https://docs.zuwiki.com/editor-guide/markdown-basics)
- [Linking between pages](https://docs.zuwiki.com/editor-guide/linking-between-pages)
- [Icons and images](https://docs.zuwiki.com/editor-guide/icons-and-images)
- [Rich content blocks](https://docs.zuwiki.com/editor-guide/rich-content-blocks)
- [OpenAPI pages](https://docs.zuwiki.com/editor-guide/openapi-pages)

### Plans & Account

- [Custom domain](https://docs.zuwiki.com/plans-account/custom-domain)
- [Zuwiki for open source](https://docs.zuwiki.com/plans-account/zuwiki-for-open-source)

### Integrations

- [MCP Server](https://docs.zuwiki.com/integrations/mcp-server)

---

# Custom domain

You can serve a wiki on a domain you own, for example `docs.yourcompany.com`. Zuwiki sets up HTTPS for you and renews the certificate. Links, OpenGraph data and analytics then use your domain instead of the default Zuwiki address.

## Setting it up

Add the domain in the wiki settings, then create two DNS records at your registrar. Zuwiki shows the exact values next to the domain.

**A routing record** points your host at Zuwiki:

| Type | Host | Value |
| --- | --- | --- |
| CNAME | `docs` (for `docs.yourcompany.com`) | `cname.zuwiki.com` |
| ALIAS or ANAME | `@` (for a root domain like `yourcompany.com`) | `cname.zuwiki.com` |

Most providers don't allow a CNAME on the root of a domain. For a bare domain, look for an ALIAS or ANAME record type. Cloudflare and Netlify DNS offer one, among others.

**A TXT record** proves the domain is yours. Create it on `_zuwiki-verify` in front of your domain, for example `_zuwiki-verify.docs`, with the token from the wiki settings as its value. The token is unique per domain and stays the same unless you remove and re add the domain.

## Verification

Zuwiki checks both records and shows one of four states:

| State | Meaning |
| --- | --- |
| Not started | The domain is added, no records found yet. |
| Pending | One of the two records is right, the other isn't. |
| Generating certificate | Both records are right and the certificate is being issued. |
| Verified | The domain is live. |

You don't have to trigger anything. Zuwiki asks your domain's own DNS servers directly instead of a cache, so a change shows up as fast as your TTL allows. For a root domain it falls back to checking an A record when there is no CNAME. The whole process usually takes a few minutes.

## If it gets stuck

- **Pending.** One record is wrong or hasn't propagated yet. Check both with `dig` or an online DNS lookup, and look closely at the exact host name.
- **Generating certificate.** The records are fine and the certificate isn't ready yet. Give it a few minutes. If nothing changes, remove the domain and add it again.
- **Browser warning about the certificate.** Renewal is automatic, but if it fails you will see a warning. Contact support.

## Removing a domain

Zuwiki stops serving the wiki on that domain and revokes the certificate. The default Zuwiki address keeps working.

Custom domains are available on every plan.
