Pinnate Docs

GitHubApp

Publish

Make a site version live on public hosts.

Publishing promotes a site snapshot to {slug}.pinnate.app and any custom domains.

When content goes live

Source

Publish behavior

Successful git sync with import

Publishes a new site version as part of sync

Console editor

Publish explicitly when using draft workflows

REST / MCP publish_site

Publishes on demand

Checklist

  1. Guide pages render as expected locally in Markdown preview

  2. Embed targets (API/SDK/CLI) are published and resolve

  3. exclude is not hiding pages you need

  4. Redirects updated if URLs moved

  5. Confirm on the default host, then custom domain

Previews

Create a shareable preview from any branch without changing the connected production branch:

  1. Open the site Integrations page

  2. Under Preview link, pick a branch and click Generate preview

  3. Open the toast URL (or append ?v=preview/<branch> yourself)

Previews:

  • Are non-current published snapshots (same host as production)

  • Keep ?v= on section and page links while you browse

  • Are noindex and exclude site search

  • Do not appear in the public version switcher

  • Replacing a preview for the same branch overwrites the previous snapshot

Production sync and publish stay on the connected branch. For a long-lived staging host, use a separate site slug instead.