SpecDefinition referenceView source

Dimensions

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.

Metadata

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

Field index

Field	Type	Req.	Description
preset	ref:DimensionPreset	—	`preset` · Allowed values `"16:9""4:3""16:10""1:1""4:5""9:16""letter""a4""widescreen""standard"`
widthInches	number	—	Custom slide width in inches; overrides the preset width when provided.
heightInches	number	—	Custom slide height in inches; overrides the preset height when provided.

`preset`

typeref:DimensionPresetrequirednodefault—

preset · Allowed values: "16:9""4:3""16:10""1:1""4:5""9:16""letter""a4""widescreen""standard"

preset.json

{
  "preset": "16:9"
}

`widthInches`

typenumberrequirednodefault—

Custom slide width in inches; overrides the preset width when provided.

`heightInches`

typenumberrequirednodefault—

Custom slide height in inches; overrides the preset height when provided.

Complete definition constraints

Schema constraints

{
  "type": "object",
  "description": "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.",
  "properties": {
    "preset": {
      "$ref": "#/$defs/DimensionPreset"
    },
    "widthInches": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Custom slide width in inches; overrides the preset width when provided."
    },
    "heightInches": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Custom slide height in inches; overrides the preset height when provided."
    }
  }
}