# Preview Data Reference

Preview-data is the canonical theme-facing content payload used by `@zeropress/build` and generated by tools such as `@zeropress/build-pages`.

Use this reference when you directly generate `preview-data.json`, review admin-generated output, or build a custom importer.

## Current Schema

- [Preview Data v0.6 Schema](/schemas/preview-data.v0.6.schema.json)

## Required Top-Level Fields

- `version`
- `generator`
- `generated_at`
- `site`
- `content`

`version` must be `"0.6"`.

Optional top-level maps include:

- `menus`
- `widgets`
- `collections`
- `custom_css`
- `custom_html`

## Core Site Fields

Common `site` fields include:

- `title`
- `description`
- `url`
- `media_base_url`
- `media_delivery_mode`
- `favicon`
- `expose_generator`
- `search`
- `locale`
- `datetime_display`
- `date_style`
- `time_style`
- `timezone`
- `front_page`
- `post_index`
- `footer`
- `indexing`
- `meta`

`site.meta` is the site-level scalar extension area. Build does not type-check it against theme hints.

## Content Fields

`content` contains:

- `authors`
- `posts`
- `pages`
- `categories`
- `tags`
- optional `media`

Posts and pages may include:

- `document_type`
- `content`
- `status`
- `discoverability`
- `meta`
- `data`

Use `meta` for scalar flags and metadata. Use `data` for structured page/post values such as facts, galleries, timelines, swatches, and stack lists.

## Discovery Policy

`discoverability` is not access control.

- `default`: normal automatic discovery.
- `noindex`: render the route and add HTML robots `noindex`.
- `delist`: render the route, add `noindex`, and remove it from automatic discovery outputs such as sitemap, native search, and generated listing data.

Explicit menus, explicit collections, and manual links can still expose a delisted page.

## Full Spec

The long-form spec remains available at [Preview Data v0.6](/spec/preview-data-v0.6.md).