Site and domain

Change your docup.dev address and see which domain features are available now and which are coming.

Settings → Site and domain shows where your docs live and lets you change the address.

Docup address#

Every site is served at your-address.docup.dev.

Open Site and domain.
Type a new value in the Address field. It is lowercased for you.
Wait for the check under the field. It tells you whether the address is available.
Choose Save.

The rules are the same as when you created the project: 3 to 40 characters, lowercase letters, numbers and hyphens, no hyphen at the start or end, and not one of the reserved names listed in Getting started.

Changing the address of a published site breaks every link that was shared with the old one. The old address stops working as soon as you save. If the site is not published yet, nothing links to it, so you can change it freely.

The Site address field shows the full address with a copy button. It always works. When your custom domain is active, it automatically redirects visitors and search engines to your custom domain.

Visibility#

Sites are Public: anyone with the link can read them, and search engines can list them unless you turn that off in Search and sharing. Private docs for authorized readers only are marked as coming soon.

Custom domain#

You can serve your docs from a subdomain you own, such as docs.acme.com. Your docup.dev address keeps working next to it.

Custom domains require Cloudflare for SaaS. If this is not set up on your server (such as in local setup), the field is disabled and shows "Custom domains are not available on this server."

Connect a custom domain#

Open Site and domain.
Type your domain in the Your own domain field.
Choose Add domain.
Log in to your DNS provider and add a CNAME record with these details:

Field	Value	Description
Type	`CNAME`	The DNS record type.
Name	Your domain (e.g., `docs.acme.com`)	Some providers require only the subdomain prefix, such as `docs`.
Target	`cname.docup.dev`	If your DNS is on Cloudflare, set the record to DNS-only (grey cloud).

Verification states#

Docup automatically checks your domain status. While waiting, the dashboard refreshes the status every 15 seconds.

State	Description	Action
Active	The domain is working. Readers find the docs here. Links, search results, and the sitemap use this domain.	None required.
Waiting for DNS	Cloudflare is checking the DNS propagation.	Wait for the DNS changes to apply, or choose Check again.
Not working	Cloudflare could not set up the domain or stopped waiting for the DNS record.	Check the DNS record, choose Check again to retry, or remove and re-add the domain.

Remove a domain#

To disconnect your domain, choose Remove next to the domain name. The docs stop answering on that domain, and all links fall back to your docup.dev address. You can add the domain again later.