$ publishing

Publishing, versioning & rollback

Every page lives at a path on its site's subdomain. Each publish is an immutable snapshot, so you can always go back.

Create a page

  1. Pick the site you want to publish to in the dashboard site switcher, then open Pages and choose New page (or start from a template).
  2. Pick a path — e.g. / for your home page or /pricing. Paths are normalized (leading slash, no trailing slash) so the dashboard and the live edge always agree.
  3. Paste or upload a full, self-contained HTML document — inline <style> and <script> are fine. hostdocs serves it as-is; nothing is stripped.
  4. Publish. The page is live at https://you.hostdocs.io/your-path within seconds.

How versioning works

Every time you publish or edit a page, hostdocs stores the HTML as a new immutable version. The page record points at the current version; older versions are kept intact. The live edge revalidates by version id (via ETag), so visitors always get the published version and cached copies update the moment you publish a new one.

  • The HTML body of each version is stored in object storage; only metadata is in the database.
  • Editing a page never overwrites history — it appends a new version.
  • The path and title can change without losing the version trail.

Roll back

  1. Open a page and switch to its Version history.
  2. Find the version you want and choose Restore.
  3. That version becomes the current one — published instantly. Rollback itself is recorded as a new version, so you can always roll forward again.

No re-upload needed

Rollback restores a snapshot that’s already stored. You don’t need the original file — just pick a version from the history.

Delete a page

Deleting a page takes it offline immediately. On team accounts, deleting is an admin-only action (members can edit but not delete).