OPF Presentation Schema Reference

This reference documents the author-facing shape of a complete *.opf.json presentation document. It summarizes the canonical schema in spec/schemas/opf.schema.json; the schema remains the source of truth for validators.

Document Contract#

• Schema id: https://openpresentation.org/schema/opf/v1
• Required top-level fields: slides
• Additional top-level fields: not allowed

Top-Level Fields#

Object And Type Reference#

Assets#

• Type: object
• Required fields: none
• Purpose: Reusable asset registry for resources used by slides, charts, metadata, and design. Keys are stable asset ids referenced elsewhere as 'asset:<id>'. Each asset can be a source string or an object with src plus optional metadata.

No named properties.

Asset#

• Type: oneOf:string / object
• Required fields: none
• Purpose: Reusable or inline resource. A string is shorthand for { "src": value }. Source strings accept 'asset:<id>' references, HTTPS URLs, data URIs, relative paths resolved against the OPF file location, or local filesystem paths. Use object form when metadata such as alt text, title or mediaType matters.

No named properties.

Audience#

• Type: anyOf:schema / schema
• Required fields: none
• Purpose: Inline audience metadata for the presentation. Use 'id' to reference an audiences record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline audience.
• Conditional requirement: id or name

Purpose#

• Type: anyOf:schema / schema
• Required fields: none
• Purpose: Inline purpose metadata for the presentation. Use 'id' to reference a purposes record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline purpose.
• Conditional requirement: id or name

Language#

• Type: object
• Required fields: bcp47
• Purpose: Inline language metadata for the presentation: a BCP-47 'bcp47' tag plus overrides of what engines know about it. Languages are an engine vocabulary, not catalog records, so there is no 'id'.

Tone#

• Type: anyOf:schema / schema
• Required fields: none
• Purpose: Inline tone metadata for the presentation. Use 'id' to reference a tones record (a bare id or 'name:id') and override selected fields, or use 'name' for a custom inline tone.
• Conditional requirement: id or name

Organization#

• Type: object
• Required fields: id, name
• Purpose: An organization associated with the presentation, typically the presenting company, but also hosts, partners, clients, or sponsors. The primary organization (role 'primary', else the first one) supplies the cover and section logo (unless design.logo overrides it) and the 'socials' header/footer field (its socials). Every field is also a built-in variable ('{{organization.name}}', 'organization.<id>.<field>'), and every logo a slide-scoped image ('var:organization.logo.icon', 'var:organization...

Speaker#

• Type: object
• Required fields: id, name
• Purpose: A person presenting the deck. A speaker is drawn only through built-in variables ('{{speaker.name}}' inside any string, a header or footer text included, and 'var:speaker.photo' as a whole image field). No layout, cover or bio slide places a speaker on its own. See docs/templates-and-variables.md.

Socials#

• Type: object
• Required fields: none
• Purpose: Social media handles or URLs, keyed by platform. The keys are an engine vocabulary validated directly (no catalog lookup): engines link a handle with the platform's URL pattern and handle prefix (spec/reference/engine-vocabularies.json). Each value is a string, either a full URL or a platform handle (e.g., '@acme'). Brand colours and icons are catalog display metadata for authoring UIs; engines render the profile URL, not icons or brand colours. Used both for organization and speaker records.

No named properties.

Design#

• Type: object
• Required fields: none
• Purpose: Visual design system applied to the presentation; individual slides may override fields via Slide.design.

ColorScheme#

• Type: object
• Required fields: none
• Purpose: Color palette used by the design system. Every slot and role is a hex color ('#RGB', '#RRGGBB' or '#RRGGBBAA'); a color-scheme name or a 'var:<id>' reference is not valid here, because those resolve through the scheme. The slot fields (accent1-accent6, dark1, dark2, light1, light2, hyperlink, followedHyperlink) mirror color-scheme.schema.json (https://openpresentation.org/schema/opf-color-scheme/v1) so library records and inline OPF overrides are interchangeable on those fields. Two parallel...

FontScheme#

• Type: object
• Required fields: none
• Purpose: Typography selections used by the design system. The pair fields (major, minor) and refinement fields (type, app, languageFamily) mirror font-scheme.schema.json (https://openpresentation.org/schema/opf-font-scheme/v1) so library records and inline OPF overrides are interchangeable on those fields. Two parallel models are supported and may be mixed: - OOXML pairs (major, minor) - heading and body family names that round-trip directly to PowerPoint majorFont/minorFont entries. - Abstract roles...

SlideDesign#

• Type: allOf:ref:Design + schema
• Required fields: none
• Purpose: A slide's design: every Design field except dimensions. A PPTX has one slide size, so the size is set once, on the deck's design.dimensions (or its theme), and a slide's design cannot set it. A slide-level theme whose resolved dimensions differ from the deck's is a validate warning (opf/slide-theme-dimensions); exporting such a deck to PPTX fails with mixed-slide-dimensions.

No named properties.

DimensionPreset#

• Type: enum:16:9 | 4:3 | 16:10 | 1:1 | 4:5 | 9:16 | letter | a4 | widescreen | standard
• Required fields: none
• Purpose: Named preset; sets aspect ratio and physical size. 16:9 ('widescreen'): 13.333 x 7.5 in, PowerPoint's Widescreen. 4:3 ('standard'): 10 x 7.5 in. 16:10: 10 x 6.25 in. letter (11 x 8.5 in) and a4 (11.69 x 8.27 in) are paper sizes, not PowerPoint's Letter Paper or A4 Paper. 1:1, 4:5 and 9:16 are 7.5 in on the short edge.

No named properties.

Dimensions#

• Type: object
• Required fields: none
• Purpose: Slide dimensions: a preset, or custom inches that override it. PowerPoint's Letter Paper (10 x 7.5 in), A4 Paper (10.8333 x 7.5 in) and On-screen Show (16:9) (10 x 5.625 in) are not OPF presets; use widthInches and heightInches. docs/slide-sizes.md compares every preset.

ThemeBackgroundSlot#

• Type: enum:light1 | light2 | dark1 | dark2
• Required fields: none
• Purpose: PowerPoint theme-controlled slide background slot from the active color scheme. These are slots, not assumptions about actual colors: light1 is usually white and dark1 is usually black by convention, but the color scheme controls the real values.

No named properties.

HexColor#

• Type: string
• Required fields: none
• Purpose: Hex color shorthand accepted by selected string fields.

No named properties.

ColorRef#

• Type: anyOf:ref:HexColor / enum:accent1 | accent2 | accent3 | accent4 | accent5 | accent6 | dark1 | dark2 | light1 | light2 | hyperlink | followedHyperlink | primary | secondary | accent | background | surface | surfaceAlt | text | textSecondary / string
• Required fields: none
• Purpose: A color value or reference, enforced on styled table cell fill and text colors, cell border colors, solid background colors, gradient stop colors and pattern foreground and background colors. Three forms: - Literal hex: '#RGB', '#RRGGBB', or '#RRGGBBAA'. - Color-scheme name, resolved through the effective color scheme after design resolution: an OOXML slot ('accent1'-'accent6', 'dark1', 'dark2', 'light1', 'light2', 'hyperlink', 'followedHyperlink') or an abstract role ('primary', 'secondary',...

No named properties.

Variables#

• Type: object
• Required fields: none
• Purpose: Named variables, keyed by stable kebab-case id. A variable is a typed, named value the deck declares once and uses in many places: a color ('var:<id>' in color fields, the original use), or content that fills a template (text, number, date, image, url, list). Content is referenced inline as '{{<id>}}' inside any string, or whole as 'var:<id>' in a field of the matching type; '{{' writes a literal '{{'. A hex string is shorthand for a color variable. A variable with no 'value' is unfilled: ex...

No named properties.

Variable#

• Type: oneOf:ref:HexColor / ref:ColorVariable / ref:TextVariable / ref:NumberVariable / ref:DateVariable / ref:ImageVariable / ref:UrlVariable / ref:ListVariable
• Required fields: none
• Purpose: A single named variable: a hex string (shorthand for a color variable) or an object whose 'type' is color, text, number, date, image, url or list. 'value' is the current value and is optional: a variable with no value is unfilled, which a template allows and a normal deck does not. 'example' only illustrates the slot (fill forms, template previews) and never reaches output.

No named properties.

ColorVariable#

• Type: object
• Required fields: type
• Purpose: A named color. Content color fields reference it as 'var:<id>'. Colors resolve at render time through the ordinary color-reference path, so a color variable keeps working as before.

TextVariable#

• Type: object
• Required fields: type
• Purpose: Text content. Plain string or rich TextRun[]. Insert it inline as '{{<id>}}' inside any string (rich text is flattened to plain text there), or reference it whole as 'var:<id>' in a field that accepts string or TextRun[] (the rich runs are kept).

NumberVariable#

• Type: object
• Required fields: type
• Purpose: A number. '{{<id>}}' inserts it as text using 'format'; 'var:<id>' as a whole field supplies the number itself (chart values, font sizes).

NumberFormat#

• Type: string
• Required fields: none
• Purpose: Number display pattern, shared by NumberVariable.format, data column formats (DataColumn.format) and table cell formats (StyledTableCell.format). An optional literal prefix, a numeric part of '#', '0', ',' and '.', and an optional literal suffix. '0' pads digits, '#' is optional, ',' groups thousands, digits after '.' fix the decimals ('0' required, '#' optional), and a '%' in the prefix or suffix multiplies the value by 100. English separators only. A format applies only to number values; st...

No named properties.

DateVariable#

• Type: object
• Required fields: type
• Purpose: A calendar date as an ISO YYYY-MM-DD string. No time zone and no clock are involved. '{{<id>}}' inserts it formatted with 'format'.

ImageVariable#

• Type: object
• Required fields: type
• Purpose: An image source: any Asset (an 'asset:<id>' reference, HTTPS URL, data URI, relative or local path, or an object with src, alt and metadata). Reference it whole as 'var:<id>' in an image, asset or src field; '{{<id>}}' inserts the source string.

UrlVariable#

• Type: object
• Required fields: type
• Purpose: A link target (http, https, mailto or tel). Use it as '{{<id>}}' inside a link string or reference it whole as 'var:<id>' in a link field.

ListVariable#

• Type: object
• Required fields: type
• Purpose: A list of strings, for bullets and list items. A whole-string array element 'var:<id>' splices every entry into the array in place; a whole field 'var:<id>' becomes the array; '{{<id>}}' joins the entries with ', ' (or the separator after a pipe: '{{<id>|; }}').

BackgroundShortcut#

• Type: oneOf:ref:ThemeBackgroundSlot / ref:HexColor / ref:ImageSource
• Required fields: none
• Purpose: String shorthand for a background. Theme slots ('light1', 'light2', 'dark1', 'dark2') are equivalent to { type: 'theme', slot: value }; hex colors are equivalent to { type: 'solid', color: value }; an image source (starting with 'asset:', 'https://', 'data:', './' or '../') is equivalent to { type: 'image', src: value }, a cover image. Any other string is invalid.

No named properties.

ImageSource#

• Type: string
• Required fields: none
• Purpose: An image source in a string shorthand: an 'asset:<id>' reference, an HTTPS URL, a data URI, or a relative path starting with './' or '../' (resolved against the OPF file location).

No named properties.

ColorVariant#

• Type: object
• Required fields: background
• Purpose: A variant of the deck's single color scheme, as a mapping over its twelve slots (PowerPoint's clrMap): 'background' is the slot the slide background and the role bg1 take, and with it the other roles: light1 maps bg1 = light1, tx1 = dark1, bg2 = light2, tx2 = dark2; dark1 maps bg1 = dark1, tx1 = light1, bg2 = dark2, tx2 = light2; light2 and dark2 make that slot both the background and the alternate surface (light2: bg1 = bg2 = light2, tx1 = dark1, tx2 = dark2; dark2: bg1 = bg2 = dark2, tx1 =...

Background#

• Type: oneOf:ref:ThemeBackground / ref:SolidBackground / ref:GradientBackground / ref:ImageBackground / ref:PatternBackground
• Required fields: none
• Purpose: Background fill applied to slides. Theme backgrounds preserve PowerPoint's color-scheme background choice; other variants represent fixed background fills.

No named properties.

ThemeBackground#

• Type: object
• Required fields: type, slot
• Purpose: Theme-controlled PowerPoint slide background. The slot is resolved through the active color scheme and remains theme-aware.

SolidBackground#

• Type: object
• Required fields: type, color
• Purpose: Fixed solid slide background fill.

GradientBackground#

• Type: object
• Required fields: type, gradient
• Purpose: Fixed gradient slide background fill.

ImageBackground#

• Type: object
• Required fields: type, src
• Purpose: Picture background: the image fills the whole canvas behind everything and never moves content (to push content aside, use an image block with placement). The string shorthand 'asset:x' (or any image source) is { type: 'image', src: 'asset:x' }, a cover image. Paint order: the colour scheme's default slide background, the picture, then the overlay, then furniture and content.

ImageFocus#

• Type: object
• Required fields: x, y
• Purpose: A point of a picture as fractions of its width and height, from the top-left corner. A cover fit centers this point in the frame as far as the picture still covers the frame, so it always stays in view: { x: 0.5, y: 0.5 } (the default) is a center crop, { x: 0, y: 0 } keeps the top-left corner.

Overlay#

• Type: object
• Required fields: color, opacity
• Purpose: Solid scrim over a picture: the whole frame in the frame's shape, or a band along one edge. Shared by image backgrounds and image blocks. Drawn directly above its picture and beneath headings and content; PowerPoint export writes one native shape above the picture.

ImagePlacement#

• Type: object
• Required fields: edge
• Purpose: Bleeds an image block to one edge of the slide: the image takes a band along that edge, edge to edge, and the headings and other content compose in the rest of the slide at the normal padding. Only top-level blocks (slides.N.blocks.I) can be placed, at most one per edge. Template layout regions do not supply image placement; set it on the image block itself. Bands are taken in block order, each spanning the free area left by earlier ones. Placement is the only mechanism that moves content asi...

ImageBorder#

• Type: object
• Required fields: color, width
• Purpose: Solid line along the image frame's shape, centered on the outline with a miter join, like a native picture line. A thick dark border on a rounded portrait frame gives a device bezel.

ImageRecolor#

• Type: oneOf:const:"grayscale" / object
• Required fields: none
• Purpose: Color treatment for the image pixels. Luminance uses Rec. 601 weights (0.299, 0.587, 0.114) on sRGB values.

No named properties.

PatternBackground#

• Type: object
• Required fields: type, pattern
• Purpose: Fixed pattern slide background fill.

OrganizationLogo#

• Type: object
• Required fields: none
• Purpose: An organization's logo in up to four shapes. Each shape is a path or Asset, or { onLight, onDark } for the two backgrounds. A missing shape falls back to full, and full to the first defined of wordmark, stacked and icon; within a shape a missing onLight or onDark uses the other. Shapes are placed with slide-scoped references such as 'var:organization.logo.icon'.

LogoSource#

• Type: oneOf:ref:Asset / object
• Required fields: none
• Purpose: One logo shape: a path or Asset for every background, or { onLight, onDark }. onLight is drawn on light backgrounds (usually dark artwork) and onDark on dark backgrounds (usually light artwork), by each slide's background; a missing one uses the other.

No named properties.

Watermark#

• Type: oneOf:schema / schema
• Required fields: opacity
• Purpose: Decorative watermark: an image ('src') or a text stamp ('text'), exactly one of the two, with its opacity. An image is drawn once per slide, contained and centered in a fixed frame (the middle 40% of the slide width and height, from 30% to 70% on each axis). A text watermark is one line of text in the heading font and the theme text color at the given opacity, centered on the slide and rotated 30 degrees counterclockwise (rising to the right), sized to span at most 70% of the slide width and...

HeaderFooter#

• Type: object
• Required fields: none
• Purpose: Repeated header or footer content split into left, center, and right zones. Header/footer content is slide furniture, separate from the main slide content payloads.

HeaderFooterItem#

• Type: object
• Required fields: none
• Purpose: One header/footer zone. Every configured field renders, side by side in one row in the order image, text, socials, date (mirrored in a right-to-left deck), aligned to the zone's edge (left, center or right) and vertically centered on each other; a line break inside text or socials ('\n') stacks lines within that part. When the parts are wider than the zone their text wraps, and a row that cannot fit even so is reported as overflow. Generated values such as the slide number, the slide count, t...

Slide#

• Type: object
• Required fields: none
• Purpose: A single slide. Content can be authored as a full-slide root payload, or inside promoted named region keys such as 'left', 'center+right', and 'top:left'.

ContentPayload#

• Type: allOf:schema + schema + schema + schema + schema + schema + schema + schema + schema + schema + schema + schema + schema
• Required fields: none
• Purpose: A content leaf or recursively composed group. A group contains blocks and optional composition; it cannot mix blocks with leaf payload fields. Groups may nest up to 32 levels.

Quote#

• Type: object
• Required fields: text
• Purpose: Quote content with optional attribution metadata. Use 'text' for the quoted text, 'attribution' for the credited person or organization, 'role' for that person's title and organization, 'photo' for their headshot and 'source' for a citation or URL. A string value in a quote field is shorthand for { "text": value }.

Code#

• Type: object
• Required fields: source
• Purpose: Code content with optional rendering metadata. Use 'source' for the code text, 'language' for syntax highlighting, 'filename' when the rendered block should show a file label, and 'highlight' to emphasize lines. A string value in a code field is shorthand for { "source": value }.

Metric#

• Type: object
• Required fields: value
• Purpose: Metric content with optional display metadata. Use 'value' for the primary value, 'label' for the metric name, 'description' for supporting context, 'unit' for a suffix/currency marker, 'delta' for change, 'trend' for direction, and 'sentiment' for whether the change is good news. A string or number value in a metric field is shorthand for { "value": value }; numeric values remain numbers and are formatted by renderers.

Timeline#

• Type: oneOf:array<ref:TimelineEvent> / object
• Required fields: none
• Purpose: Timeline content. An array is shorthand for { "events": value }; object form carries optional name and description metadata.

No named properties.

TimelineEvent#

• Type: object
• Required fields: what
• Purpose: A single event inside a timeline content payload.

ListItem#

• Type: oneOf:string / array<ref:TextRun> / object
• Required fields: none
• Purpose: A flat item inside a list. Strings cover the common case, TextRun[] supports inline rich text without an object wrapper, and object form adds description and nesting depth without creating nested slide content payloads.

No named properties.

BulletItem#

• Type: oneOf:string / array<ref:TextRun> / object
• Required fields: none
• Purpose: A flat bullet item. Strings cover the common case, TextRun[] supports inline rich text without an object wrapper, and object form adds nesting depth without list-item descriptions.

No named properties.

NumberingStyle#

• Type: enum:arabic | roman-upper | roman-lower | alpha-upper | alpha-lower
• Required fields: none
• Purpose: A list number style: 1, 2, 3; I, II, III; i, ii, iii; A, B, C; a, b, c. Alphabetic numbering past 26 repeats the letter as PowerPoint does (aa, bb, cc). Roman numerals stop at 3999; larger values are drawn in arabic with a numbering-adapted diagnostic.

No named properties.

Numbering#

• Type: object
• Required fields: none
• Purpose: Numbering of one list level.

NumberingSpec#

• Type: oneOf:ref:NumberingStyle / ref:Numbering / array<oneOf:ref:NumberingStyle / ref:Numbering>
• Required fields: none
• Purpose: The value of a numbering field: a style name or Numbering object for every level, or an array with one entry per level (at most 9, the native depth).

No named properties.

TextRun#

• Type: oneOf:string / object
• Required fields: none
• Purpose: A contiguous run of text. Strings cover unformatted spans; object form adds character formatting.

No named properties.

Caption#

• Type: oneOf:string / array<ref:TextRun> / object
• Required fields: none
• Purpose: A caption for an image, chart, table or video payload. A string or TextRun[] is the caption text placed below the media; object form adds the position and alignment.

No named properties.

Reference#

• Type: object
• Required fields: id, text
• Purpose: A source that runs cite with 'cite'. Cited references are listed in the footnote area of the slides that cite them, numbered per deck in order of first use; referencesSlide() builds an ordinary list slide of them.

Chart#

• Type: object
• Required fields: type, data
• Purpose: Chart content. The chart object keeps chart-specific fields together so slides and regions do not expose loose chart fields.

ChartAxisTitles#

• Type: object
• Required fields: none
• Purpose: Titles for the axes of a chart. 'category' is the axis that carries the row labels (the horizontal axis of a column or line chart, the vertical axis of a bar chart, the X axis of a scatter chart); 'value' is the other axis; 'secondary' is the secondary value axis of a combo chart.

ChartHighlight#

• Type: object
• Required fields: none
• Purpose: Which series and categories a chart emphasizes. Names are matched exactly: series by data column name (after any 'fields' selection; a series is a plotted value column), categories by row label (the first column, or mapping.category), as text. A category label shared by several rows highlights each of them.

ChartDataLabels#

• Type: object
• Required fields: none
• Purpose: Data label settings. A label shows the selected content parts in the fixed order category, value, percent, joined by the separator.

Table#

• Type: object
• Required fields: none
• Purpose: Table content, inline or dataset-backed. An inline table has 'rows' (required) and optional 'columns'. A dataset-backed table has 'dataset' (required) and optional 'fields', and no 'rows' or 'columns': it takes its headers, rows and column formats from the dataset (per-cell styles need an inline table).
• Conditional requirement: dataset, or otherwise rows

ChartData#

• Type: object
• Required fields: columns, rows
• Purpose: Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless 'chart.mapping' or a chart type maps them differently. Value cells are numbers; a string is read only in strict decimal syntax ('12', '-3.5', '1e6'), and anything else ('12%', '$5', '(5)', '1,234') is a gap and a 'chart-value-not-numeric' warning.

DataColumn#

• Type: object
• Required fields: name
• Purpose: A named data column with an optional number format. Anywhere a chart or dataset column is a string it may be a DataColumn; the string form is { "name": value } with no format. A table column header may also be a DataColumn.

DataSourceRef#

• Type: object
• Required fields: src
• Purpose: Provenance of inline data or a dataset: the file, sheet and range it came from and when. Engines never read, fetch or refresh it; they keep it through editing, export and re-import. Re-import the data to update it.

DatasetId#

• Type: string
• Required fields: none
• Purpose: Id of an entry in the top-level datasets map (the assets id pattern).

No named properties.

DatasetFields#

• Type: array<string>
• Required fields: none
• Purpose: Dataset column names to use, in order, each at most once. Selects and orders the dataset's columns; an unknown name is a 'dataset-field-unknown' error.

No named properties.

Datasets#

• Type: object
• Required fields: none
• Purpose: Shared data tables keyed by id (the assets id pattern). Charts reference one with 'chart.data': { "dataset": "<id>" } and tables with 'table': { "dataset": "<id>" }.

No named properties.

Dataset#

• Type: object
• Required fields: columns, rows
• Purpose: One shared data table: named columns (strings or DataColumn objects with a number format) and rows of scalar cells. Column names are unique ('data-column-duplicate' error). Rich text and styling belong in an inline table.

DatasetRef#

• Type: object
• Required fields: dataset
• Purpose: Chart data taken from a top-level dataset. Engines inline it before plotting; 'chart.mapping' names columns after the 'fields' selection.

ChartMapping#

• Type: object
• Required fields: none
• Purpose: Series mapping by column name (after any 'fields' selection). Mapping only selects and orders columns; pie, doughnut and other single-series constructs still plot one series. An unknown name is a 'chart-mapping-unknown-column' error; a series that repeats the category or X column, and an X column on a chart type without an X axis, are dropped with a 'chart-mapping-adapted' warning.

ChartDataCell#

• Type: oneOf:string / number / boolean / null
• Required fields: none
• Purpose: A cell in inline chart data.

No named properties.

TableCell#

• Type: oneOf:ref:TableCellValue / ref:StyledTableCell
• Required fields: none
• Purpose: A scalar, rich-run array, or styled/spanning cell object. Existing scalar and rich forms remain valid.

No named properties.

TableCellValue#

• Type: oneOf:string / number / boolean / null / array<ref:TextRun>
• Required fields: none
• Purpose: A scalar table value or canonical rich text runs, without cell decoration or geometry.

No named properties.

StyledTableCell#

• Type: object
• Required fields: value
• Purpose: A cell with explicit visual style or merged geometry. Its position remains its array column index; use null placeholders for every covered grid position.

TableCellStyle#

• Type: object
• Required fields: none
• Purpose: Cell appearance. Sizes use reference pixels at a 720-pixel canvas short edge and scale with the slide.

TableCellPadding#

• Type: object
• Required fields: none
• Purpose: Text insets in reference pixels. Defaults: top 8, right 10, bottom 4, left 10.

TableCellBorder#

• Type: object
• Required fields: color, width
• Purpose: One explicit cell border.

Catalogs#

• Type: object
• Required fields: none
• Purpose: The catalog records a document embeds, grouped by the catalog they came from. Each property is a group; inside a group, records are keyed by kind and then by id. - 'default': the catalog bare ids come from. It needs a 'source' when it holds records. Omitted: bare ids fall back to the host's default catalog. false: no catalog fallback, so every bare id must be embedded (under 'custom' or 'default'). - 'custom': the records the document defines itself. It has no source. - any other name ('acme'...

CatalogGroup#

• Type: object
• Required fields: none
• Purpose: One catalog group: the catalog's source and the records of it the document embeds, by kind and then by id.

CatalogSource#

• Type: string
• Required fields: none
• Purpose: Identity of a catalog: an HTTPS URL ('https://www.pptx.gallery') or a package reference ('pkg:@acme/opf-catalog'). It names the catalog; engines never fetch or install it. A host registers the catalog's records under this exact string, and copying slides between documents matches groups by it.

No named properties.

CatalogRecords#

• Type: object
• Required fields: none
• Purpose: Embedded records of one kind, keyed by id. The key is the record's id; an embedded record carries no '$schema', 'id', origin or digest. Catalog display metadata ('x-*' members) is stripped when a record is embedded.

No named properties.

CatalogReference#

• Type: string
• Required fields: none
• Purpose: A content reference: a bare id ('two-column') or 'name:id' ('acme:hero'), where the prefix names a group of 'catalogs'. URLs and 'pkg:' strings are not references; a named catalog group replaces them. See Catalogs for the resolution order.

No named properties.

LanguageTag#

• Type: string
• Required fields: none
• Purpose: A BCP-47 language tag ('en-US', 'ja', 'zh-Hans', 'sr-Latn-ME'), an engine vocabulary. Use 'en-GB' for UK English; 'en-UK' is not a valid region.

No named properties.

Composition#

• Type: object
• Required fields: none
• Purpose: Automatic slide and content-group arrangement. Nested content groups arrange their children independently, inheriting only minFontSize and overflow. Explicit promoted regions retain their positions. A layout defines its grid as one ordered list of regions; its composition supports gap, padding, minFontSize and overflow rather than mode, columns or weights.