Hillnote Logo

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:

  1. You must have a publishing username. This becomes the first part of your site's address.
  2. 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!.
  3. 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.

  1. Open Settings ▸ Profile and find Publishing username.
  2. Click Set username.
  3. Type 3 to 30 lowercase letters, numbers and hyphens, starting and ending with a letter or number. Hillnote shows whether it's available.
  4. Click Save username.
The Publishing username card in Settings ▸ Profile, showing the username and its sites.hillnote.com address.

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

  1. Open Settings ▸ Sites.
  2. Under Synced Workspaces, find the workspace and click Publish.
  3. Wait while its status moves from Queued to Building… to Live.
  4. Click the address under its name to open the site.
Settings ▸ Sites with a workspace marked Live and its address under its name.

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:

StatusMeaning
QueuedWaiting for the build to start.
Building…The site is being built.
LiveThe build succeeded and your site is online.
FailedThe 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:

  1. Make sure your changes have synced.
  2. In Settings ▸ Sites, click Rebuild. This pulls in your latest synced content and rebuilds the site.
A published workspace in Settings ▸ Sites, with its build status and the Rebuild button.

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.

Site Options open under a published workspace, with its Layout switches.

Layout (on/off)

OptionWhat it controls
Top Navbar (Pinned Docs)A top navigation bar with your pinned documents and folders.
Floating NavbarShows the navbar as a floating bar.
Navigation SidebarThe document navigation sidebar.
Floating SidebarShows the sidebar as a floating panel.
Table of ContentsThe on-page table of contents.
Dark Mode ToggleA light/dark mode switch for visitors.
SearchSite search.
Sidebar EmojisDocument and folder emojis in the sidebar.
Author's NotesYour comments, shown at the end of each page.

The two navbar switches start off. The rest start on.

Database, branding and appearance

OptionWhat it controls
Database View StyleHow every collection (database) shows: Minimal List or Table.
Home PageThe page visitors see first. By default, it's the first document.
Display NameThe name shown for your site (up to 100 characters). Left empty, it's the workspace name.
Logo URL / Logo SizeA link to a logo image, and its height (24–96 px).
Favicon EmojiAn emoji used as the site's favicon.
Default ThemeSystem (follow the visitor's device), Light or Dark.
Sidebar Background / Content BackgroundCustom 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:

  1. In Settings ▸ Sites, click Custom Domain under the site.
  2. Type your domain and click Add.
  3. 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.
  4. Click Check Status until it says Active.
The Custom Domain panel for docs.example.com, showing the CNAME record to add at your DNS provider.

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.com or 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.com address 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 Unpublish Workspace confirmation, saying it will remove your published site while the workspace and synced files are not affected, with Cancel and Unpublish.

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:

PlanPublish limitCustom domains
Free0 (publishing not available)—
Plus1—
Pro6✅
Ultra30✅

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.