A Group holds other blocks and lines them up: one under another, side by side, or in a grid. Use it for two columns of text, a row of buttons, a card with a photo and a caption, or a sidebar beside a list of posts. A Group can hold other Groups.
You can add a Group to every section type and inside a Collection, a Form, another Group, a No Results block or a Paywall. In the block picker it sits under Common. Move, group and arrange blocks shows how to put blocks you already have into a Group.
A new, empty Group shows three cards inside it on the canvas: Stack (one below another), Row (side by side) and Grid (across rows). Click one to set its layout. Dashed cells then show the layout, and the + in the first cell adds the first block. The canvas toolbar offers the same three choices. Once the Group holds blocks, change Layout in the right sidebar. In the tables below, "the + menu" is the + beside the name of a group of settings, such as General, in that panel.
General
Setting
What it does
Layout
How the blocks inside sit: Stack (the default) puts them one under another, Row puts them side by side, and Grid puts them in columns of equal width.
Justification
Where the blocks sit across the Group. In a stack: Left, Center, Right or Stretch (the default), which makes every block as wide as the Group. In a row: Left (the default), Center, Right or Space between, which pushes the first and the last block to the edges. A grid has no Justification. Set it with the Justification button on the canvas toolbar.
Alignment
Shows for a row or a grid. Where blocks of different heights sit: Top, Middle, Bottom or Stretch (the default), which makes them all as tall as the tallest. Set it with the Alignment button on the canvas toolbar.
Wrap
Shows when Layout is Row. On by default, it moves blocks to a new line when the row is full. Turned off, they stay on one line and get narrower.
Reverse
Shows for a stack or a row. Shows the blocks from the last to the first. Use it when a column sits on the right on a computer but should come first on a phone: switch the preview to Mobile and turn it on there. Add it from the + menu beside General.
Max columns
Shows when Layout is Grid. The most blocks in one row of the grid, from 2 to 16. The default is 2.
Min column width
Shows when Layout is Grid. The narrowest a column can get, from 3 to 38 rem. The default is 16 rem, about 256 px. When the columns can't keep this width, the grid shows fewer per row.
Separated
Draws a thin line between the blocks, in the middle of the gap. Add it from the + menu.
Link to its page
Shows only inside a Collection. Makes the whole Group open the page of the post, tag or author it shows, such as a whole post card.
Link
Makes the whole Group open a link, such as /about or https://example.com. Links and buttons inside it keep their own. Add it from the + menu. Inside a Collection it shows when Link to its page is off.
Link label
Shows when the Group has a link. What screen readers announce for the link. Empty, they read the first heading inside the Group.
Justification and Alignment show in the panel only after you give them a different value for tablets or phones. Every setting in this group except the link settings can change per screen size: a row on a computer can become a stack on a phone. Change the design on tablets and phones explains how.
Layout
Setting
What it does
Sticky
Keeps the Group in view under the site header while the rest of its container scrolls past. Use it for a sidebar next to a long list of posts. Add it from the + menu beside Layout.
Hold pinned blocks
Shows for a Group inside another Group or a Form. On by default: blocks pinned inside this Group sit over it. Turned off, they sit over the Group around it. Add it from the + menu.
The group also holds Width, Min Height, Aspect Ratio and Position. Layout settings describes them, and how pinned blocks work.
Spacing
Setting
What it does
Gap
The space between the blocks inside, Small (24 px) by default. Click the link icon to set the space between columns and between rows separately.
Padding
The space between the Group's edges and its blocks. Use it when the Group has a background or a border. Add it from the + menu.
A Group can have its own Color Scheme, a Background or Gradient, a Text color for the text inside it, and under Appearance a Fill, a Fill image, a Border, Corners and a Shadow. Together with Padding, they turn a Group into a card or a colored box. Colors and appearance settings describes them.
Blocks
A Group takes almost every block: text, buttons, images, forms and Collections. The picker offers only the blocks that fit where the Group sits. Inside a Collection, for example, it also offers the data blocks of the post, tag or author.
A Group holds other blocks and lines them up: one under another, side by side, or in a grid. Use it for two columns of text, a row of buttons, a card with a photo and a caption, or a sidebar beside a list of posts. A Group can hold other Groups.
You can add a Group to every section type and inside a Collection, a Form, another Group, a No Results block or a Paywall. In the block picker it sits under Common. Move, group and arrange blocks shows how to put blocks you already have into a Group.
A new, empty Group shows three cards inside it on the canvas: Stack (one below another), Row (side by side) and Grid (across rows). Click one to set its layout. Dashed cells then show the layout, and the + in the first cell adds the first block. The canvas toolbar offers the same three choices. Once the Group holds blocks, change Layout in the right sidebar. In the tables below, "the + menu" is the + beside the name of a group of settings, such as General, in that panel.
General
/aboutorhttps://example.com. Links and buttons inside it keep their own. Add it from the + menu. Inside a Collection it shows when Link to its page is off.Justification and Alignment show in the panel only after you give them a different value for tablets or phones. Every setting in this group except the link settings can change per screen size: a row on a computer can become a stack on a phone. Change the design on tablets and phones explains how.
Layout
The group also holds Width, Min Height, Aspect Ratio and Position. Layout settings describes them, and how pinned blocks work.
Spacing
The spacing names, such as Small, come from Page widths and spacing.
Colors and appearance
A Group can have its own Color Scheme, a Background or Gradient, a Text color for the text inside it, and under Appearance a Fill, a Fill image, a Border, Corners and a Shadow. Together with Padding, they turn a Group into a card or a colored box. Colors and appearance settings describes them.
Blocks
A Group takes almost every block: text, buttons, images, forms and Collections. The picker offers only the blocks that fit where the Group sits. Inside a Collection, for example, it also offers the data blocks of the post, tag or author.
A Group also has the Display settings and Advanced settings of every block.