{}OPF
DocsAuthoring guide

Implicit blocks shorthand

Use multiple slide-root content payloads when composition matters but explicit placement does not.

Overview

OPF supports blocks for slides that contain multiple content payloads but do not need explicit placement. A block can be any concrete content payload: text, list, image, chart, table, code, metric, quote, timeline, or video.

For authoring convenience, OPF also accepts multiple root-level content payloads on a slide as shorthand for blocks, when placement is unspecified.

Example

This slide uses multiple root-level content payloads.

implicit-blocks-shorthand.opf.json
{
  "title": "Evidence Snapshot",
  "text": "Jaguar populations are declining due to habitat fragmentation.",
  "chart": {
    "type": "line",
    "data": {
      "columns": [
        "Year",
        "Population Index"
      ],
      "rows": [
        [
          "2020",
          100
        ],
        [
          "2021",
          94
        ],
        [
          "2022",
          88
        ]
      ]
    }
  },
  "quote": {
    "text": "Jaguar conservation depends on connected habitat.",
    "attribution": "Field researcher"
  }
}

Renderers treat it as equivalent to explicit layout-agnostic blocks.

explicit-blocks.opf.json
{
  "title": "Evidence Snapshot",
  "blocks": [
    {
      "text": "Jaguar populations are declining due to habitat fragmentation."
    },
    {
      "chart": {
        "type": "line",
        "data": {
          "columns": [
            "Year",
            "Population Index"
          ],
          "rows": [
            [
              "2020",
              100
            ],
            [
              "2021",
              94
            ],
            [
              "2022",
              88
            ]
          ]
        }
      }
    },
    {
      "quote": {
        "text": "Jaguar conservation depends on connected habitat.",
        "attribution": "Field researcher"
      }
    }
  ]
}

Rules

This shorthand only applies at the slide root, and only when the slide has no explicit type, no blocks, and no promoted region keys such as left, right, or top:center.

Root-level payload fields include text, items, bullets, image, chart, table, code, metric, quote, timeline, and video.

Placement

If exact placement matters, use promoted regions. If composition matters but placement should remain renderer-defined, use blocks directly.

See the OPF schema reference for the full slide and content payload field list.