Design

Metadata

Fields

theme

Type: string | ref:Theme · Optional · Default: —

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

Type: string | ref:ColorScheme · Optional · Default: —

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

Type: string | ref:FontScheme · Optional · Default: —

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

Type: ref:DimensionPreset | ref:Dimensions · Optional · Default: —

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

{
  "dimensions": "widescreen"
}

background

Type: ref:BackgroundShortcut | ref:Background · Optional · Default: —

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

Type: ref:Asset | ref:LogoSet · Optional · Default: —

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

Type: const | ref:Asset | ref:Watermark · Optional · Default: —

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

Type: const | ref:HeaderFooter · Optional · Default: —

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

{
  "header": false
}

footer

Type: const | ref:HeaderFooter · Optional · Default: —

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

{
  "footer": false
}

titleAlignment

Type: enum · Optional · Default: —

Default horizontal alignment for title placeholders in resolved layouts.

{
  "titleAlignment": "left"
}

contentAlignment

Type: enum · Optional · Default: —

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

{
  "contentAlignment": "left"
}

contentBox

Type: boolean · Optional · Default: —

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

{
  "contentBox": true
}

slideImage

Type: ref:Asset | object · Optional · Default: —

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

{
  "slideImage": "slideImage-value"
}

contentDirection

Type: enum · Optional · Default: —

Axis along which parallel body/content regions are arranged.

{
  "contentDirection": "horizontal"
}

chartPrimary

Type: enum · Optional · Default: —

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

{
  "chartPrimary": "none"
}

imageFill

Type: enum · Optional · Default: —

How picture placeholders fill their allocated region.

{
  "imageFill": "crop"
}

listBullet

Type: enum · Optional · Default: —

Default bullet rendering style for list layouts.

{
  "listBullet": "character"
}