Publish your guide

3 min readUpdated Oct 31, 2026

Builds on The editor.

Drafts are private. Publishing takes every page's current draft and the guide's settings, builds the guide, and puts it live at its address. Readers keep seeing the previous version until the new one is ready, a few seconds later.

Open the guide's Publishes tab, or choose Publish… in the editor.

See what changed

#

The left side lists the changes since the last publish:

  • pages that are New, Edited (with how many lines changed and who changed them) or Deleted, each with View changes to open the page
  • guide settings that changed, like Theme and brand, Sidebar order, Ask AI or Redirects, each with Open

Before the first publish, every page shows as new. When nothing has changed, it says Everything is published.

Publish the changes

#
  1. Describe it

    #

    Under Publish, add a note in What changed (optional), like "Rewrote Quickstart for the new onboarding". It's shown in the publish history.

  2. Publish

    #

    Choose Publish. The new publish appears at the top of Publishes with its progress: Waiting to build, then Building the guide with each step.

  3. It's live

    #

    When it's done, the publish is marked Live and a message says where. Readers see the new version within a few seconds.

If the guide requires a review, editors and reviewers see Submit for review instead of Publish. Admins can always publish.

Publishing while a build is running is fine: changes that come in meanwhile go into the next publish, and a publish that hasn't started yet is replaced by the newer one (it's listed as replaced, not built).

If a publish fails

It's marked Failed with the reason, and nothing changed for readers: they keep the last live version. Fix what it says and publish again. See Troubleshooting.

There's a daily number of publishes per guide while Markdrop Guides is in beta. If you reach it, the message says so; restoring an earlier publish doesn't count.

What gets published

#
  • every page's current draft, including hidden pages
  • the sidebar order, theme and brand, Ask AI settings and redirects
  • the images and files the pages use

Deleted pages disappear from the guide. A publish takes each page's draft as last saved at the moment you choose Publish; edits saved after that wait for the next one.

Restore an earlier publish

#

Every publish is kept. A Guides admin can put an earlier one live again:

  1. In Publishes, choose Restore on the publish you want.
  2. Confirm with Restore.

It takes a few seconds and doesn't rebuild anything. Your drafts don't change, so the next Publish publishes them again. To switch back, restore the newer publish.

Take a guide down

#

Unpublish in Guide settings takes the guide offline and keeps everything; publishing again puts it back.

Did this page help?