Skip to main content

Hide drafts and partials

Keep unfinished pages out of production and mark build-only Markdown that must never become public content.

Set draft: true while a page is not ready to publish:

content/blog/upcoming-release.md
---
title: Upcoming release
draft: true
---

# Upcoming release

The filesystem provider includes drafts during nuxt dev. In production, public queries, routes, navigation, search, and sitemap output exclude them. Remove draft when the page is ready.

The filesystem provider cannot preview drafts on a production deployment. Production reads built content and rejects authenticated preview requests. Use a content provider when editors need a secured preview workflow on a deployed site.

Mark build-only Markdown as a partial

Prefix a filename with _ to mark it as a partial:

content/
  guides/
    installation.md
    _shared-requirements.md

Ginko parses underscore partials so build-time tooling can inspect them. It excludes them from public queries and routes in every environment.

Partials are not an include system. A page cannot pull _shared-requirements.md into its body. Use an MDC component for a reusable rendered block.

Keep a page off the menu

Set navigation: false when a page should stay reachable but drop out of the generated menu:

md
---
title: Direct-link reference
navigation: false
---

The page keeps its URL and remains searchable. This setting only removes the navigation entry; it is not access control.