Building a page from blocks

The block editor occupies the main part of the page edit screen.

1. On the page's edit screen, select Add block. A picker opens, listing every block available on this site in alphabetical order.
2. Find the block. On sites where the developer has installed the searchable picker, the picker has a Search blocks field, which matches a block's name and its internal key (typing "cta" finds Call to Action).
3. Select the block. It is added to the page.
4. Expand the block and complete its fields. Fields differ between blocks: a Rich Text block has a body, an Image block has a picture and its alt text, and a Call to Action block has a heading and a button.
5. Repeat for each block the page needs.
6. Select Save & publish to publish the page, or open More actions and select Save to keep the change as a draft. Section 8 describes both.

Blocks are collapsed in the editor when the page opens. A collapsed block shows its type and, once it has content, a short label taken from that content, for example "Rich Text :: Introduction".

To change the order of blocks, drag a block by its handle and drop it in its new position. Blocks render top to bottom in the order shown in the editor.

Each block's header also has a clone action, which inserts a copy of the block directly below it, and a delete action. Deleting a block removes it from the draft; bringing it back afterwards requires restoring an earlier version. To take a block off the page reversibly, use its Hide setting instead, which is described in the next section.

Container blocks

Four blocks are containers. A container has no content fields of its own beyond a heading or labels; it holds a list of other blocks.

Each list inside a container has its own Add block button and the same picker. The lists in one container are independent: one tab can hold a paragraph and a picture, the next a table, and the next a call to action.

A collapsed container states how many blocks it holds, for example "3 blocks", and reads Empty when it holds none. Check that count before collapsing a container, because an empty container and a full one look the same when collapsed.

Containers have two restrictions:

1. A container cannot be placed inside another container. A set of tabs cannot go inside a column.
2. Five blocks cannot be placed inside any container, because each one belongs to the page as a whole: Page Heading, Breadcrumbs, **Table of Contents, Series Navigation and Snippet**. These blocks are absent from the picker inside a container.