Publishing Your Workspace
Hillnote lets you turn any synced workspace into a public website. Your documents become web pages, hosted for you at a Hillnote address (or your own custom domain). The site updates whenever you rebuild it.
This guide explains how publishing works, what you get, and how to manage your published sites.
What is a published workspace?
When you publish a workspace, Hillnote builds a static website from the synced copy of your documents and hosts it publicly. Each published workspace gets its own address:
https://sites.hillnote.com/<your-username>/<workspace-slug>
your-username: your publishing username (see Set a username).workspace-slug: a URL-safe version of your workspace name, made automatically (e.g. "My Travel Notes" →my-travel-notes).
Anyone with the address can read your site. The site is a snapshot: it changes only when you rebuild it. Workspaces you don't publish stay private. To share a single page with chosen people instead, see Sign-in to sync.
Before you publish
A workspace must meet three requirements before it can be published:
- You must have a publishing username. This becomes the first part of your site's address.
- The workspace must have been synced. Hillnote builds the site from the synced copy of your workspace, so a workspace that has never synced can't be published. Only the workspace owner can publish it. To sync one, see Sign-in to sync and unlock premium features!.
- Your plan must include publishing. Publishing needs a paid plan, and each plan can publish a set number of workspaces (see Plans & limits).
How publishing works, step by step
1. Set a username
Your publishing username is the public name that appears in every published address.
- Open Settings ▸ Profile and find Publishing username.
- Click Set username.
- Type 3 to 30 lowercase letters, numbers and hyphens, starting and ending with a letter or number. Hillnote shows whether it's available.
- Click Save username.

You can change your username once every 30 days. When you do, your published sites are rebuilt and move to the new address.
Your public profile lives at
https://sites.hillnote.com/<your-username>and lists all of your currently-published workspaces.
2. Publish a workspace
- Open Settings ▸ Sites.
- Under Synced Workspaces, find the workspace and click Publish.
- Wait while its status moves from Queued to Building… to Live.
- Click the address under its name to open the site.

The Cloud Sync card at the top shows how many sites you've published out of your limit. If you haven't set a username yet, or you've reached your limit, Hillnote tells you and offers a button to fix it (Open Profile or View Plans).
3. The build runs
Publishing doesn't happen instantly. Hillnote queues a build, and a background worker builds the static site: it converts each document to a web page, generates a search index, a sitemap and a robots.txt, and uploads everything to Hillnote's hosting.
Your published workspace moves through these statuses:
| Status | Meaning |
|---|---|
| Queued | Waiting for the build to start. |
| Building… | The site is being built. |
| Live | The build succeeded and your site is online. |
| Failed | The build hit an error. The reason is shown below it. |
Settings ▸ Sites follows the build for you and shows when the site goes live. If a build fails, fix the problem and click Rebuild to try again.
4. Your site goes live
Once the status says Live, your address works and anyone with the link can view the site. Click the Live status or the address to open it.
What gets published
- Documents in
documents/. Workspace variables show their values. - Slides, as decks visitors can click through.
- Collections (databases) and their rows. Archived rows are left out.
- Embedded sheets, as tables of their first 200 rows.
- Comments, as Author's Notes at the end of the page, with names but no email addresses.
Left out: pages you lock with Lock with password, moodboards, the contents of libraries (only the library's card appears), and files outside documents/, such as agents.md. Libraries are hosted another way, with Publish to Hillnote Cloud. See Library.
Updating a published site
Your published site is a snapshot. Editing documents in the app doesn't change the live site until you rebuild it:
- Make sure your changes have synced.
- In Settings ▸ Sites, click Rebuild. This pulls in your latest synced content and rebuilds the site.

Saving new Site Options rebuilds the site too (see Customizing your site). Only one build runs at a time, so Rebuild waits while a build is queued or in progress.
Customizing your site
Click Site Options under a published workspace, make your changes, then click Save & Rebuild (or Discard). Options are saved for each published workspace and applied when it rebuilds.
The options come in four groups: Layout, Database & Blog, Branding and Appearance. The two tables below cover them all.

Layout (on/off)
| Option | What it controls |
|---|---|
| Top Navbar (Pinned Docs) | A top navigation bar with your pinned documents and folders. |
| Floating Navbar | Shows the navbar as a floating bar. |
| Navigation Sidebar | The document navigation sidebar. |
| Floating Sidebar | Shows the sidebar as a floating panel. |
| Table of Contents | The on-page table of contents. |
| Dark Mode Toggle | A light/dark mode switch for visitors. |
| Search | Site search. |
| Sidebar Emojis | Document and folder emojis in the sidebar. |
| Author's Notes | Your comments, shown at the end of each page. |
The two navbar switches start off. The rest start on.
Database, branding and appearance
| Option | What it controls |
|---|---|
| Database View Style | How every collection (database) shows: Minimal List or Table. |
| Home Page | The page visitors see first. By default, it's the first document. |
| Display Name | The name shown for your site (up to 100 characters). Left empty, it's the workspace name. |
| Logo URL / Logo Size | A link to a logo image, and its height (24–96 px). |
| Favicon Emoji | An emoji used as the site's favicon. |
| Default Theme | System (follow the visitor's device), Light or Dark. |
| Sidebar Background / Content Background | Custom hex colors (e.g. #1a1a2e). |
Invalid values are quietly corrected to safe defaults. For example, a malformed color is ignored, and an unrecognized theme falls back to System.
Custom domains
By default your site is served from sites.hillnote.com. On the Pro and Ultra plans you can connect your own domain (e.g. docs.example.com) once the site is Live.
How it works:
- In Settings ▸ Sites, click Custom Domain under the site.
- Type your domain and click Add.
- At your DNS provider, add the CNAME record Hillnote shows, which points your domain to
sites.hillnote.com. Add the verification record it shows too. - Click Check Status until it says Active.

While Hillnote waits for your records, the status says Pending. It may say Deploying while the SSL certificate is issued. Once it says Active, your site opens at your domain.
To stop using the domain, click Remove Domain, then Confirm remove?.
Notes & restrictions:
- Custom domains require a Pro or Ultra plan.
- You can't use
hillnote.comor its subdomains. - A domain can only be connected to one published workspace at a time.
- Removing a domain detaches it from your site (your
sites.hillnote.comaddress keeps working).
Unpublishing
In Settings ▸ Sites, click Unpublish, then confirm. This takes the site offline and deletes its hosted files. If a custom domain was attached, it's disconnected too.

The workspace and its synced files aren't affected, and you can publish the workspace again later.
Plans & limits
How many workspaces you can publish depends on your plan:
| Plan | Publish limit | Custom domains |
|---|---|---|
| Free | 0 (publishing not available) | — |
| Plus | 1 | — |
| Pro | 6 | ✅ |
| Ultra | 30 | ✅ |
If you reach your publish limit, unpublish a workspace or upgrade your plan in Settings ▸ Plans & Subscription. To compare plans, see the pricing page.
Rate limits
To keep the build system healthy, publishing is rate-limited:
- Publish / rebuild / option changes: up to 10 per hour per user.
- Status checks: up to 60 per minute per user.
These limits are generous for normal use. You'd only hit them by republishing very rapidly in a short window.
Troubleshooting
"Set a publishing username first"
You need a publishing username first. Click Open Profile, set one, then try again.
"Workspace must be synced at least once before publishing."
Sync the workspace, then publish.
"You've reached your publish limit."
Unpublish an existing site, or click View Plans to upgrade.
"This workspace is already published."
Use Rebuild to update it instead of publishing a second time.
Build failed.
The reason is shown under the Failed status. Fix the issue if you can, then click Rebuild. A failed build can always be retried.
"A build is already in progress."
Wait for the current build to finish, then make your change.
"This workspace name produces a reserved URL slug."
Some names (index, sitemap, resources and search-data) collide with reserved site paths. Rename the workspace so its slug is unique and valid, then publish.
"A workspace with this slug is already published."
Another of your published workspaces has a name that makes the same address. Rename one of them, then publish.
"Too many attempts. Please wait a few minutes and try again."
You've hit a rate limit. Wait a few minutes, then try again.
For problems with sync, AI or the app itself, see Fix common problems.