Open Presentation Format spec

The JSON contract for slides, content, layouts and reusable design records.

Document contract

A canonical presentation is valid JSON with a nonempty slides array. Save it as *.opf.json. Markdown and YAML authoring forms convert to this same value.

Complete minimal deck

{
  "slides": [
    {
      "title": "Your message"
    }
  ]
}

Presentation and layout

Start with the deck contract. Layout records declare one ordered list of regions and the content each region accepts.

PresentationThe complete deck: slides, shared design, assets and data.SlideThe content and design of one slide.ContentText, lists, charts, tables and other slide content.Slide LayoutOne ordered list of regions: direction, sizes and content rules.

Catalog schemas

Record contracts for reusable design, story and engine vocabularies. Gallery owns the published records.

AudienceAudience profile and presentation context.Chart TypeChart vocabulary and engine mappings.Color SchemePowerPoint color slots and palette metadata.Font SchemeHeading, body, code and script font families.LanguageLanguage tags, writing direction and font choices.Narrative TemplateStory structure and suggested slide flow.PurposePresentation goals and expected audience action.Social PlatformSocial profile URL patterns and display metadata.ThemeReusable colors, fonts, backgrounds and dimensions.ToneVoice and writing-style guidance.

Validation

Check a deck and understand what needs attention.

Validation resultsErrors, warnings and suggested fixes.

For tool developers

Indexes and manifests for catalog and preview tooling.

Catalog IndexPublished record IDs and source filenames.Catalog Snapshot ManifestCatalog snapshot source, record counts and content hashes.Layout Preview IndexLayout IDs, SVG filenames and byte lengths.

Definitions

Browse every content, design, data, asset, catalog and value definition.

All definitions Chart

Documentation snapshot

OpenPresentation/opf@d68561fad7b2b319cd7cdb8d7e75fefdd1dffa4c

Raw source links use this exact snapshot. Published package versions are listed separately. Published package versions.