Default subdomain
Every project gets a free subdomain at <slug>.nookdocs.site the moment it's created. The slug is whatever you pick on the new-project screen — so a project with slug acme-docs is live at https://acme-docs.nookdocs.site.
SSL is auto-provisioned; there's nothing to configure.
Constraints
Slugs are immutable-looking but actually rename-able. See Renaming below.
| Rule | Example |
| 3–32 characters | a (too short), acme-docs-for-the-entire-enterprise-and-more (too long) |
| Lowercase letters, digits, and hyphens only | acme-docs ✅, Acme_Docs ❌ |
| Must start and end with a letter or digit | -acme ❌, acme- ❌ |
| No consecutive hyphens | acme--docs ❌ |
| Not a reserved subdomain | api ❌, www ❌ |
Validation runs both in the create form and on the server — we reject anything that slips through the client check.
Renaming
Yes, you can change your slug after you've shipped.
Open Settings → Domain
In the dashboard, pick your project and open the Domain section.
Change the slug
Type the new slug. Validation runs inline so you'll see conflicts and format errors before you hit save.
Confirm the rename
We move the site to the new subdomain and set up a redirect from the old one. The old subdomain keeps working for 90 days, returning a 301 to the new URL — enough time to update any links and let search engines re-index.
The 90-day redirect window is a hard deadline. After that, the old subdomain becomes eligible for someone else to claim.
Reserved subdomains
Some subdomains are permanently reserved for platform infrastructure and can never be claimed by a project:
| Reserved | Used for |
api | Public REST API (api.nookdocs.com) |
app | Dashboard (app.nookdocs.com) |
www, nookdocs, nookdocs | Marketing site |
admin, dashboard, account | Reserved for future auth flows |
docs | docs.nookdocs.com (NookDocs' own docs) |
status, health, monitor | Reserved for status pages |
mail, email, smtp, imap | Reserved for email infrastructure |
If you need a slug that's currently reserved, open a support ticket — we may be able to release it case-by-case.
Ready to use your own domain?
See Custom domain for attaching docs.yourcompany.com.