SpecDefinition referenceView source

Slide

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'.

Metadata

Definition: #/$defs/Slide
Form: object
Source: spec/schemas/opf.schema.json

Field index

Field	Type	Req.	Description
id	string	—	Optional stable identifier for the slide within the document. Use when another system needs to reference a slide across edits, comments, generation state, exports, or narrative tooling. Slide order is defined by the slides array, so simple decks may omit this.
type	enum	—	Optional full-slide content kind. When omitted, engines infer the kind from root payload fields. `type` · Allowed values `"text""list""image""chart""table""video""code""metric""quote""timeline"`
beat	string \| array<string>	—	Optional reference to one or more beats of the deck's narrative (each value is the id of a beat in the narrative record that the root 'narrative' resolves to). A single string declares the slide's primary beat; an array declares that one slide covers multiple beats. Declares the slide's role in the story arc; does not constrain ordering or structure. Core validate warns about a beat id the resolved narrative does not define, and reports a beat that no slide references. Slides without a beat are valid; multiple slides may share a beat.
layout	ref:CatalogReference	—	Optional layout: a layouts reference, a bare id ('pillars') or 'name:id' ('acme:hero'), or 'auto'. When omitted or 'auto', the slide is composed with no layout record: engines arrange title, subtitle, tag and content automatically, a slide with no body payload is a cover (vertically centered), and design hints apply; there is no finding. 'auto' is reserved, so no catalog may define a layout of that id, and opf format drops it. A layout is a grid template (layout.schema.json): the slide's content stays flat and binds to the layout's regions by reading order, role and kind, a block may pin itself to a region with 'region', and an empty region collapses. A reference that resolves nowhere is the warning opf/unresolved-reference (and the 'unresolved-reference' diagnostic of resolveSlideContext), the slide composes automatically, and a strict export fails. A layout id of the 0.18 default catalog that 0.19 no longer has is such a reference: 0.19 has no migration path for layouts. A layout never changes what a slide contains, and engines never substitute a different layout.
title	string \| array<ref:TextRun>	—	Slide-level title content. A v2 layout renders this in its title heading area, or an implicit heading row when that area is absent. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.
subtitle	string \| array<ref:TextRun>	—	Slide-level subtitle or supporting line. A v2 layout renders this in its subtitle area when present, otherwise in the title heading group. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.
tag	string \| array<ref:TextRun>	—	Small slide-level label or badge. A v2 layout renders this before the title in its title heading group; tag is not a separate layout area. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.
text	string \| array<ref:TextRun>	—	Full-slide text payload. Use a string for plain text or TextRun[] for inline rich text. TextRun items may be plain strings or formatted run objects.
items	array<ref:ListItem>	—	Full-slide structured list payload. Presence of this field infers type 'list'. Entries are strings, TextRun[] or objects with text, optional description (supporting detail under the entry), level and start. Use items when entries share a shape (features, steps, options, risks) or any entry needs a description; use bullets for plain talking points. Both draw the same marker, nesting and numbering; they differ in the inferred kind and in description, which only items accepts. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks, so items next to text or bullets composes as separate blocks side by side.
bullets	array<ref:BulletItem>	—	Full-slide prose bullet payload: short talking points, each standing alone. Presence of this field infers type 'text', so it may sit beside text in one payload. Entries are strings, TextRun[] or objects with text, level and start; there is no description (use items for entries with supporting detail).
numbering	ref:NumberingSpec	—	Number the full-slide items or bullets instead of bulleting them. A style name (arabic, roman-upper, roman-lower, alpha-upper, alpha-lower) or a Numbering object applies to every list level; an array gives one entry per level (index = level, the last entry repeats for deeper levels). Counting follows PowerPoint: consecutive entries of one level count up from its start, and an entry of a shallower level restarts the deeper levels. Absent = bullets. Valid only with items or bullets. Native PowerPoint export writes a:buAutoNum with the matching scheme and startAt; the preview draws the same numbers at the same marker geometry. `numbering` · Named choices (see schema for other values and constraints) `"arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"`
image	ref:Asset	—	Shorthand for one image block: the picture composes as body content, like { type: 'image', image: value }, with the effective design.imageFit. A v2 layout binds it to a compatible body region; a region's bleed setting may extend its outer edges to the slide edge. For fit, focus, treatments or an explicit placement use an image block in blocks; for a full-slide picture behind the content use design.background. Presence of this field infers type 'image'.
video	ref:Asset	—	Full-slide video source. Presence of this field infers type 'video'. Engines do not play video: the preview draws a placeholder (a play badge with the asset's title or source as its caption), and PPTX export draws the same placeholder as native shapes linked to an http(s) source, with no embedded media. Native playback is out of scope (docs/programs/release-readiness).
chart	ref:Chart	—	Full-slide chart payload. Presence of this field infers type 'chart'.
table	ref:Table	—	Full-slide table payload. Presence of this field infers type 'table'.
code	string \| ref:Code	—	Full-slide code payload. A string is shorthand for { "source": value }; object form carries optional syntax language and filename metadata.
metric	string \| number \| ref:Metric	—	Full-slide metric payload. A string or number is shorthand for { "value": value }; object form carries optional label, description, unit, delta, trend, and sentiment metadata. Numeric values remain numbers; renderers format them for display. Presence of this field infers type 'metric'.
quote	string \| ref:Quote	—	Full-slide quote payload. A string is shorthand for { "text": value }; object form carries optional attribution and source metadata. Presence of this field infers type 'quote'.
timeline	ref:Timeline	—	Full-slide timeline payload. An array is shorthand for { "events": value }; object form carries optional name and description metadata. Presence of this field infers type 'timeline'.
caption	ref:Caption	—	Caption for the slide's root image, chart, table or video payload. Valid only when the slide root holds exactly one of those payloads.
blocks	array<ref:ContentPayload>	—	Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for equivalent blocks.
design	ref:SlideDesign	—	Slide-level design applied on top of the deck-wide design.
left	ref:ContentPayload	—
center	ref:ContentPayload	—
right	ref:ContentPayload	—
left+center	ref:ContentPayload	—
center+right	ref:ContentPayload	—
left+center+right	ref:ContentPayload	—
top	ref:ContentPayload	—
middle	ref:ContentPayload	—
bottom	ref:ContentPayload	—
top+middle	ref:ContentPayload	—
middle+bottom	ref:ContentPayload	—
top+middle+bottom	ref:ContentPayload	—
top:left	ref:ContentPayload	—
top:center	ref:ContentPayload	—
top:right	ref:ContentPayload	—
top:left+center	ref:ContentPayload	—
top:center+right	ref:ContentPayload	—
top:left+center+right	ref:ContentPayload	—
middle:left	ref:ContentPayload	—
middle:center	ref:ContentPayload	—
middle:right	ref:ContentPayload	—
middle:left+center	ref:ContentPayload	—
middle:center+right	ref:ContentPayload	—
middle:left+center+right	ref:ContentPayload	—
bottom:left	ref:ContentPayload	—
bottom:center	ref:ContentPayload	—
bottom:right	ref:ContentPayload	—
bottom:left+center	ref:ContentPayload	—
bottom:center+right	ref:ContentPayload	—
bottom:left+center+right	ref:ContentPayload	—
top+middle:left	ref:ContentPayload	—
top+middle:center	ref:ContentPayload	—
top+middle:right	ref:ContentPayload	—
top+middle:left+center	ref:ContentPayload	—
top+middle:center+right	ref:ContentPayload	—
top+middle:left+center+right	ref:ContentPayload	—
middle+bottom:left	ref:ContentPayload	—
middle+bottom:center	ref:ContentPayload	—
middle+bottom:right	ref:ContentPayload	—
middle+bottom:left+center	ref:ContentPayload	—
middle+bottom:center+right	ref:ContentPayload	—
middle+bottom:left+center+right	ref:ContentPayload	—
top+middle+bottom:left	ref:ContentPayload	—
top+middle+bottom:center	ref:ContentPayload	—
top+middle+bottom:right	ref:ContentPayload	—
top+middle+bottom:left+center	ref:ContentPayload	—
top+middle+bottom:center+right	ref:ContentPayload	—
top+middle+bottom:left+center+right	ref:ContentPayload	—
notes	string	—	Speaker notes shown in presenter view.
section	string	—	PowerPoint-style slide section label. Consecutive slides with the same value belong to the same section in presenter view, outlines, and PowerPoint section-aware exports. Also the slide-scoped built-in variable '{{slide.section}}', for example in a header text.
hidden	boolean	—	Whether the slide is hidden from the presented sequence. The player skips it, the PPTX export writes it as a hidden slide, and per-slide image and PDF output skips it unless the caller asks to include hidden slides (opf CLI: --include-hidden; the deck-level toSvg: the opt-in skipHidden). A slide named explicitly (opf convert --slides, toSvg with a slide number) is still rendered.
composition	ref:Composition	—
extensions	object	—	Custom data passthrough for agent workflows at slide scope; ignored by the engine but preserved across read/write round-trips. Use for review state, generation provenance, or authoring conventions such as { "authoring": { "locked": true } }.

`id`

typestringrequirednodefault—

Optional stable identifier for the slide within the document. Use when another system needs to reference a slide across edits, comments, generation state, exports, or narrative tooling. Slide order is defined by the slides array, so simple decks may omit this.

id.json

{
  "id": "s1"
}

`type`

typeenumrequirednodefault—

Optional full-slide content kind. When omitted, engines infer the kind from root payload fields.

type · Allowed values: "text""list""image""chart""table""video""code""metric""quote""timeline"

type.json

{
  "type": "text"
}

`beat`

typestring | array<string>requirednodefault—

Optional reference to one or more beats of the deck's narrative (each value is the id of a beat in the narrative record that the root 'narrative' resolves to). A single string declares the slide's primary beat; an array declares that one slide covers multiple beats. Declares the slide's role in the story arc; does not constrain ordering or structure. Core validate warns about a beat id the resolved narrative does not define, and reports a beat that no slide references. Slides without a beat are valid; multiple slides may share a beat.

`layout`

typeref:CatalogReferencerequirednodefault—

Optional layout: a layouts reference, a bare id ('pillars') or 'name:id' ('acme:hero'), or 'auto'. When omitted or 'auto', the slide is composed with no layout record: engines arrange title, subtitle, tag and content automatically, a slide with no body payload is a cover (vertically centered), and design hints apply; there is no finding. 'auto' is reserved, so no catalog may define a layout of that id, and opf format drops it. A layout is a grid template (layout.schema.json): the slide's content stays flat and binds to the layout's regions by reading order, role and kind, a block may pin itself to a region with 'region', and an empty region collapses. A reference that resolves nowhere is the warning opf/unresolved-reference (and the 'unresolved-reference' diagnostic of resolveSlideContext), the slide composes automatically, and a strict export fails. A layout id of the 0.18 default catalog that 0.19 no longer has is such a reference: 0.19 has no migration path for layouts. A layout never changes what a slide contains, and engines never substitute a different layout.

layout.json

{
  "layout": "cover"
}

`title`

typestring | array<ref:TextRun>requirednodefault—

Slide-level title content. A v2 layout renders this in its title heading area, or an implicit heading row when that area is absent. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.

title.json

{
  "title": "Quarterly Review"
}

`subtitle`

typestring | array<ref:TextRun>requirednodefault—

Slide-level subtitle or supporting line. A v2 layout renders this in its subtitle area when present, otherwise in the title heading group. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.

subtitle.json

{
  "subtitle": "Prepared for the board"
}

`tag`

typestring | array<ref:TextRun>requirednodefault—

Small slide-level label or badge. A v2 layout renders this before the title in its title heading group; tag is not a separate layout area. Use a string for plain text or TextRun[] for inline rich text (a colored word, bold, a link, a citation or footnote marker); the heading keeps its size and fitting rules either way, and run colors resolve like body text.

tag.json

{
  "tag": "Intro"
}

`text`

typestring | array<ref:TextRun>requirednodefault—

Full-slide text payload. Use a string for plain text or TextRun[] for inline rich text. TextRun items may be plain strings or formatted run objects.

`items`

typearray<ref:ListItem>requirednodefault—

Full-slide structured list payload. Presence of this field infers type 'list'. Entries are strings, TextRun[] or objects with text, optional description (supporting detail under the entry), level and start. Use items when entries share a shape (features, steps, options, risks) or any entry needs a description; use bullets for plain talking points. Both draw the same marker, nesting and numbering; they differ in the inferred kind and in description, which only items accepts. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for layout-agnostic blocks, so items next to text or bullets composes as separate blocks side by side.

`bullets`

typearray<ref:BulletItem>requirednodefault—

Full-slide prose bullet payload: short talking points, each standing alone. Presence of this field infers type 'text', so it may sit beside text in one payload. Entries are strings, TextRun[] or objects with text, level and start; there is no description (use items for entries with supporting detail).

`numbering`

typeref:NumberingSpecrequirednodefault—

Number the full-slide items or bullets instead of bulleting them. A style name (arabic, roman-upper, roman-lower, alpha-upper, alpha-lower) or a Numbering object applies to every list level; an array gives one entry per level (index = level, the last entry repeats for deeper levels). Counting follows PowerPoint: consecutive entries of one level count up from its start, and an entry of a shallower level restarts the deeper levels. Absent = bullets. Valid only with items or bullets. Native PowerPoint export writes a:buAutoNum with the matching scheme and startAt; the preview draws the same numbers at the same marker geometry.

numbering · Named choices (see schema for other values and constraints): "arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"
numbering (oneOf 2).style · Allowed values: "arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"
numbering (oneOf 2).suffix · Allowed values: "period""paren""paren-both"
numbering (oneOf 3)[] · Named choices (see schema for other values and constraints): "arabic""roman-upper""roman-lower""alpha-upper""alpha-lower"

numbering.json

{
  "numbering": "arabic"
}

`image`

typeref:Assetrequirednodefault—

Shorthand for one image block: the picture composes as body content, like { type: 'image', image: value }, with the effective design.imageFit. A v2 layout binds it to a compatible body region; a region's bleed setting may extend its outer edges to the slide edge. For fit, focus, treatments or an explicit placement use an image block in blocks; for a full-slide picture behind the content use design.background. Presence of this field infers type 'image'.

`video`

typeref:Assetrequirednodefault—

Full-slide video source. Presence of this field infers type 'video'. Engines do not play video: the preview draws a placeholder (a play badge with the asset's title or source as its caption), and PPTX export draws the same placeholder as native shapes linked to an http(s) source, with no embedded media. Native playback is out of scope (docs/programs/release-readiness).

`chart`

typeref:Chartrequirednodefault—

Full-slide chart payload. Presence of this field infers type 'chart'.

chart.type · Allowed values: "100pct-stacked-area", "100pct-stacked-bar", "100pct-stacked-column", "area", "bar", "box-and-whisker", "column", "combo", "doughnut", "filled-radar", "funnel", "histogram", "line", "line-with-markers", "pareto", "pie", "radar", "radar-with-markers", "scatter", "stacked-area", "stacked-bar", "stacked-column", "stacked-line", "stacked-line-with-markers", "treemap", "waterfall", "world"
chart.legend · Allowed values: "none", "top", "bottom", "left", "right"
chart.dataLabels (oneOf 2).content[] · Allowed values: "value", "percent", "category"
chart.dataLabels (oneOf 2).position · Allowed values: "auto", "center", "inside-end", "inside-base", "outside-end", "above", "below", "left", "right"
chart.colors[] · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"

`table`

typeref:Tablerequirednodefault—

Full-slide table payload. Presence of this field infers type 'table'.

table.columns[] (oneOf 3).style.fill · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
table.columns[] (oneOf 3).style.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
table.columns[] (oneOf 3).style.align · Allowed values: "left", "center", "right"
table.columns[] (oneOf 3).style.verticalAlign · Allowed values: "top", "middle", "bottom"
table.columns[] (oneOf 3).style.borders.top.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
table.columns[] (oneOf 3).style.borders.top.dash · Allowed values: "solid", "dash", "dot"

`code`

typestring | ref:Coderequirednodefault—

Full-slide code payload. A string is shorthand for { "source": value }; object form carries optional syntax language and filename metadata.

`metric`

typestring | number | ref:Metricrequirednodefault—

Full-slide metric payload. A string or number is shorthand for { "value": value }; object form carries optional label, description, unit, delta, trend, and sentiment metadata. Numeric values remain numbers; renderers format them for display. Presence of this field infers type 'metric'.

metric (oneOf 3).trend · Allowed values: "up""down""flat"
metric (oneOf 3).sentiment · Allowed values: "positive""negative""neutral"

`quote`

typestring | ref:Quoterequirednodefault—

Full-slide quote payload. A string is shorthand for { "text": value }; object form carries optional attribution and source metadata. Presence of this field infers type 'quote'.

`timeline`

typeref:Timelinerequirednodefault—

Full-slide timeline payload. An array is shorthand for { "events": value }; object form carries optional name and description metadata. Presence of this field infers type 'timeline'.

timeline (oneOf 1)[].status · Allowed values: "done""current""planned"

`caption`

typeref:Captionrequirednodefault—

Caption for the slide's root image, chart, table or video payload. Valid only when the slide root holds exactly one of those payloads.

caption (oneOf 3).position · Allowed values: "below""above"
caption (oneOf 3).align · Allowed values: "left""center""right"

`blocks`

typearray<ref:ContentPayload>requirednodefault—

Layout-agnostic content blocks rendered together as a composed payload when exact placement is unspecified. At slide root, multiple content payload kinds with no explicit type, blocks, or regions are accepted as shorthand for equivalent blocks.

blocks[].type · Allowed values: "text", "list", "image", "chart", "table", "video", "code", "metric", "quote", "timeline", "group"
blocks[].numbering · Named choices (see schema for other values and constraints): "arabic", "roman-upper", "roman-lower", "alpha-upper", "alpha-lower"
blocks[].numbering (oneOf 2).style · Allowed values: "arabic", "roman-upper", "roman-lower", "alpha-upper", "alpha-lower"
blocks[].numbering (oneOf 2).suffix · Allowed values: "period", "paren", "paren-both"
blocks[].numbering (oneOf 3)[] · Named choices (see schema for other values and constraints): "arabic", "roman-upper", "roman-lower", "alpha-upper", "alpha-lower"
blocks[].columns · Named choices (see schema for other values and constraints): "auto"
blocks[].fit · Allowed values: "cover", "contain", "stretch"
blocks[].shape · Allowed values: "rectangle", "rounded", "circle", "hexagon"
blocks[].border.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].recolor · Named choices (see schema for other values and constraints): "grayscale"
blocks[].recolor (oneOf 2).dark · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].recolor (oneOf 2).light · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].overlay.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].overlay.edge · Allowed values: "top", "bottom", "left", "right"
blocks[].placement.edge · Allowed values: "left", "right", "top", "bottom"
blocks[].chart.type · Allowed values: "100pct-stacked-area", "100pct-stacked-bar", "100pct-stacked-column", "area", "bar", "box-and-whisker", "column", "combo", "doughnut", "filled-radar", "funnel", "histogram", "line", "line-with-markers", "pareto", "pie", "radar", "radar-with-markers", "scatter", "stacked-area", "stacked-bar", "stacked-column", "stacked-line", "stacked-line-with-markers", "treemap", "waterfall", "world"
blocks[].chart.legend · Allowed values: "none", "top", "bottom", "left", "right"
blocks[].chart.dataLabels (oneOf 2).content[] · Allowed values: "value", "percent", "category"
blocks[].chart.dataLabels (oneOf 2).position · Allowed values: "auto", "center", "inside-end", "inside-base", "outside-end", "above", "below", "left", "right"
blocks[].chart.colors[] · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].table.columns[] (oneOf 3).style.fill · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].table.columns[] (oneOf 3).style.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].table.columns[] (oneOf 3).style.align · Allowed values: "left", "center", "right"
blocks[].table.columns[] (oneOf 3).style.verticalAlign · Allowed values: "top", "middle", "bottom"
blocks[].table.columns[] (oneOf 3).style.borders.top.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
blocks[].table.columns[] (oneOf 3).style.borders.top.dash · Allowed values: "solid", "dash", "dot"
blocks[].metric (oneOf 3).trend · Allowed values: "up", "down", "flat"
blocks[].metric (oneOf 3).sentiment · Allowed values: "positive", "negative", "neutral"
blocks[].timeline (oneOf 1)[].status · Allowed values: "done", "current", "planned"
blocks[].caption (oneOf 3).position · Allowed values: "below", "above"
blocks[].caption (oneOf 3).align · Allowed values: "left", "center", "right"
blocks[].composition.mode · Allowed values: "auto", "grid", "row", "column"
blocks[].composition.overflow · Allowed values: "warn", "error"

`design`

typeref:SlideDesignrequirednodefault—

Slide-level design applied on top of the deck-wide design.

design (allOf 1).fontScheme (oneOf 2).type · Allowed values: "sans-serif", "serif", "monospace"
design (allOf 1).fontScheme (oneOf 2).app · Allowed values: "powerpoint", "google-slides"
design (allOf 1).fontScheme (oneOf 2).languageFamily · Allowed values: "latin", "ea", "cs", "eastAsian", "complexScript"
design (allOf 1).dimensions · Named choices (see schema for other values and constraints): "16:9", "4:3", "16:10", "1:1", "4:5", "9:16", "letter", "a4", "widescreen", "standard"
design (allOf 1).dimensions (oneOf 2).preset · Allowed values: "16:9", "4:3", "16:10", "1:1", "4:5", "9:16", "letter", "a4", "widescreen", "standard"
design (allOf 1).background · Named choices (see schema for other values and constraints): "light1", "light2", "dark1", "dark2"
design (allOf 1).background (oneOf 2) (oneOf 1).type · Allowed values: "theme"
design (allOf 1).background (oneOf 2) (oneOf 1).slot · Allowed values: "light1", "light2", "dark1", "dark2"
design (allOf 1).background (oneOf 2) (oneOf 2).type · Allowed values: "solid"
design (allOf 1).background (oneOf 2) (oneOf 2).color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).background (oneOf 2) (oneOf 3).tone · Allowed values: "dark", "light"
design (allOf 1).background (oneOf 2) (oneOf 3).type · Allowed values: "gradient"
design (allOf 1).background (oneOf 2) (oneOf 3).gradient.stops[].color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).background (oneOf 2) (oneOf 4).tone · Allowed values: "dark", "light"
design (allOf 1).background (oneOf 2) (oneOf 4).type · Allowed values: "image"
design (allOf 1).background (oneOf 2) (oneOf 4).fit · Allowed values: "cover", "contain", "stretch", "tile"
design (allOf 1).background (oneOf 2) (oneOf 4).recolor · Named choices (see schema for other values and constraints): "grayscale"
design (allOf 1).background (oneOf 2) (oneOf 4).recolor (oneOf 2).dark · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).background (oneOf 2) (oneOf 4).recolor (oneOf 2).light · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).background (oneOf 2) (oneOf 4).overlay.color · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).background (oneOf 2) (oneOf 4).overlay.edge · Allowed values: "top", "bottom", "left", "right"
design (allOf 1).background (oneOf 2) (oneOf 5).type · Allowed values: "pattern"
design (allOf 1).background (oneOf 2) (oneOf 5).pattern.foregroundColor · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).background (oneOf 2) (oneOf 5).pattern.backgroundColor · Named choices (see schema for other values and constraints): "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"
design (allOf 1).variant · Named choices (see schema for other values and constraints): "light1", "light2", "dark1", "dark2"
design (allOf 1).variant (oneOf 2).background · Allowed values: "light1", "light2", "dark1", "dark2"
design (allOf 1).variant (oneOf 2).accents[] · Allowed values: "accent1", "accent2", "accent3", "accent4", "accent5", "accent6"
design (allOf 1).logo · Named choices (see schema for other values and constraints): false
design (allOf 1).watermark · Named choices (see schema for other values and constraints): false
design (allOf 1).header · Named choices (see schema for other values and constraints): false
design (allOf 1).footer · Named choices (see schema for other values and constraints): false
design (allOf 1).titleAlignment · Allowed values: "left", "center", "right"
design (allOf 1).contentAlignment · Allowed values: "left", "center", "right"
design (allOf 1).contentDirection · Allowed values: "horizontal", "vertical"
design (allOf 1).chartPrimary · Allowed values: "none", "top", "bottom", "left", "right"
design (allOf 1).imageFit · Allowed values: "cover", "contain", "stretch"
design (allOf 1).listBullet · Allowed values: "character", "image", "none"