Rows and columns
Inside a section, content sits in rows. A row is split into cells, and each cell holds its own stack of blocks. That is how you get a picture beside a paragraph instead of under it.
Columns
Section titled “Columns”A row can hold up to four cells. Beyond that a proposal column is too narrow to read on a phone, where every column collapses to full width anyway.
Relative widths
Section titled “Relative widths”By default the cells in a row share the space equally. Widths let you weight them instead — they are ratios, not pixels or percentages:
| Widths | Result |
|---|---|
[1, 1] |
Two equal columns |
[1, 2] |
A third and two thirds |
[2, 1] |
Two thirds and a third |
[1, 1, 2] |
A quarter, a quarter and a half |
The list has to have exactly as many entries as the row has cells. A [1, 2] on a
three-cell row does not partly apply — it is discarded, and the row renders as equal
columns.
Nesting
Section titled “Nesting”A cell can contain its own rows, one level deep. That covers the realistic case — a two-column split where one side is itself stacked — without letting a proposal turn into a grid nobody can maintain. Rows nested deeper than one level are dropped.
On small screens
Section titled “On small screens”Columns collapse to full width and stack in reading order: left to right, then top to bottom. Check a multi-column section in preview before sending — a caption placed to the right of an image ends up underneath it on a phone, which is usually fine, but occasionally reads wrong.
This page for language models
The same content as plain text, for an AI assistant to read.