Design

Metadata

Definition

#/$defs/Design

Type

object

Source

spec/schemas/opf.schema.json

Field index

theme

typestring | ref:Themerequirednodefault—

Theme for the deck. Accepts two forms: - String shorthand: 'design.theme = "minimal"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'themes' catalog record. - Object form: a Theme with an optional 'id' base reference plus theme-level overrides. Inline overri…

{
  "theme": "minimal"
}

colorScheme

typestring | ref:ColorSchemerequirednodefault—

Color scheme for the presentation. Accepts two forms: - String shorthand: 'design.colorScheme = "cool-horizon"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'colorSchemes' catalog record. - Object form: a ColorScheme with an optional 'id' base reference plu…

{
  "colorScheme": "cool-horizon"
}

fontScheme

typestring | ref:FontSchemerequirednodefault—

Font scheme for heading, body, accent, and code text. Accepts two forms: - String shorthand: 'design.fontScheme = "aptos"'. Bare id, HTTPS URL, or 'pkg:' reference resolved as the 'id' of a 'fontSchemes' catalog record. - Object form: a FontScheme with an optional 'id' base refe…

{
  "fontScheme": "aptos"
}

dimensions

typeref:DimensionPreset | ref:Dimensionsrequirednodefault—

Slide dimensions and aspect ratio. String shorthand such as 'widescreen' is equivalent to { preset: 'widescreen' }.

{
  "dimensions": "widescreen"
}

background

typeref:BackgroundShortcut | ref:Backgroundrequirednodefault—

Default slide background applied across the deck unless overridden on a slide. String shorthand accepts theme slots ('light1', 'light2', 'dark1', 'dark2') or hex colors; object forms support theme, solid, gradient, image, or pattern fills.

{
  "background": "dark1"
}

logo

typeref:Asset | ref:LogoSetrequirednodefault—

Deck logo assets used by layouts, covers, section dividers, headers, and footers. A string is the default logo source; object form provides light/dark, stacked, icon, and wordmark variants. When omitted, the renderer falls back to the primary organization logo.

{
  "logo": "asset:acme-logo"
}

watermark

typeconst | ref:Asset | ref:Watermarkrequirednodefault—

Optional decorative watermark applied across slides. Use false to suppress an inherited watermark in slide-level design; a string is equivalent to { src: value }.

{
  "watermark": false
}

header

typeconst | ref:HeaderFooterrequirednodefault—

Repeated header furniture rendered outside the main slide content. Use false to suppress an inherited header.

{
  "header": false
}

footer

typeconst | ref:HeaderFooterrequirednodefault—

Repeated footer furniture rendered outside the main slide content. Use false to suppress an inherited footer.

{
  "footer": false
}

titleAlignment

typeenumrequirednodefault—

Default horizontal alignment for title placeholders in resolved layouts.

{
  "titleAlignment": "left"
}

contentAlignment

typeenumrequirednodefault—

Default horizontal alignment for body/content regions in resolved layouts.

{
  "contentAlignment": "left"
}

contentBox

typebooleanrequirednodefault—

Whether body/content regions are rendered inside a visible card or surface.

{
  "contentBox": true
}

slideImage

typeref:Asset | objectrequirednodefault—

Optional slide-level image treatment used by layouts that support a decorative or editorial image separate from content images.

{
  "slideImage": "slideImage-value"
}

contentDirection

typeenumrequirednodefault—

Axis along which parallel body/content regions are arranged.

{
  "contentDirection": "horizontal"
}

chartPrimary

typeenumrequirednodefault—

For chart layouts, where the primary chart sits relative to supporting content. 'none' means chart regions have equal weight.

{
  "chartPrimary": "none"
}

imageFill

typeenumrequirednodefault—

How picture placeholders fill their allocated region.

{
  "imageFill": "crop"
}

listBullet

typeenumrequirednodefault—

Default bullet rendering style for list layouts.

{
  "listBullet": "character"
}