$ 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
- 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).
- 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. - Paste or upload a full, self-contained HTML document — inline
<style>and<script>are fine. hostdocs serves it as-is; nothing is stripped. - Publish. The page is live at
https://you.hostdocs.io/your-pathwithin 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
- Open a page and switch to its Version history.
- Find the version you want and choose Restore.
- 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).