Promoted regions
Use promoted region keys when slide content needs explicit placement but should still remain renderer-portable.
Overview
Promoted regions are slide-root keys such as left, right, center+right, and top:center. Each region contains one concrete content payload, and the key tells the renderer where that payload belongs.
Use regions when placement matters. Use implicit blocks or explicit blocks when composition matters but placement should remain renderer-defined.
Region keys
OPF supports simple columns, simple rows, and row-column intersections.
Columns
left
center
right
left+center
center+right
left+center+right
Rows
top
middle
bottom
top+middle
middle+bottom
top+middle+bottom
Intersections
top:left
top:center
middle:right
bottom:center+right
top+middle:left+center
Examples
A two-column slide can pin a table left and a chart across the remaining width.
{
"title": "Operating Snapshot",
"left": {
"table": {
"columns": [
"Metric",
"Value"
],
"rows": [
[
"Revenue",
"$4.2M"
],
[
"Gross margin",
"68%"
]
]
}
},
"center+right": {
"chart": {
"type": "line",
"data": {
"columns": [
"Month",
"Revenue"
],
"rows": [
[
"Jan",
3.4
],
[
"Feb",
3.8
],
[
"Mar",
4.2
]
]
}
}
}
}A grid-style slide can combine row and column spans.
{
"title": "Launch Readiness",
"top:left": {
"metric": {
"value": "92%",
"label": "Beta activation",
"trend": "up"
}
},
"top:center+right": {
"text": "Customer teams are ready for phased rollout."
},
"middle+bottom:left+center+right": {
"items": [
"Finalize launch comms",
"Confirm migration owners",
"Prepare support coverage"
]
}
}Rules
- Region keys only apply at the slide root.
- Region values are content payloads such as text, items, image, chart, table, metric, quote, or timeline.
- Do not mix region keys with root payload fields such as
text,chart, orblocks. - Do not use overlapping region keys on the same slide.