Basker Docs

Rich Text

A flexible container that groups other blocks together inside a sized, styled band.

The Rich Text block is a container that holds other blocks together as one self-contained band of content. It carries its own width and height, its own background and borders, and its own arrangement controls.

Use it to lay out a stand-alone strip of content — a centred heading and paragraph, a row of buttons, an opening-hours panel — and control how wide and tall that strip sits on the page.

Rich Text is not the Text block

Despite the name, Rich Text is a layout container, not a place to write prose. If you want to type a paragraph, use the Text block instead. Rich Text holds blocks; Text holds words. It is also distinct from the rich text editor, the writing surface and toolbar you type into inside the Text and Heading blocks.

Blocks

The Blocks field is the heart of this container. Add child blocks to it and they stack inside the band, following the arrangement you set on the Layout tab.

You can add any of these inside a Rich Text container:

  • Divider, Group, Button, Button Links, Heading, Logo, Media, Navigation, Opening Hours, Sponsors, Text, and Custom Attribute.

A Rich Text container can hold a Group, letting you nest a tighter cluster of blocks inside the wider band.

Arrangement

The Layout tab decides how the child blocks sit relative to one another.

  • Direction — stack the blocks Vertical (one above the next) or run them Horizontal (side by side). Default: Vertical.
  • Vertical on Mobile — when set to Horizontal, this stacks the blocks vertically on small screens so they stay readable. On by default. (Appears only with Direction set to Horizontal.)
  • Alignment — line the blocks up Left, Center, Right, or Space Between. Default: Left.
  • Position — push the blocks to the Top, Center, or Bottom of the band, or Space Between to spread them. Default: Top.
  • Gap — the space between each block, from 0 to 120 px in steps of 4. Default: 24 px.

Size

The Size tab sets how wide and tall the whole band runs.

  • WidthFull Width spans edge to edge, Page sits within the normal page margins, Narrow keeps the band tight and centred. Default: Page.
  • HeightAuto grows to fit its content, or fix it to Small, Medium, Large, Full (the height of the screen), or Custom. Default: Auto.
  • Custom Height — a slider from 200 to 1000 px in steps of 50, defaulting to 400 px. Appears only when Height is set to Custom.

Shared controls

Rich Text exposes its remaining controls as tabs on the block itself. Each works the same as it does on other blocks:

Example

A narrow, centred content band with a heading and a paragraph:

Add the Rich Text block

Drop a Rich Text block onto the page.

Add the content

In the Blocks field, add a Heading and a Text block. Type your title and paragraph into each.

Size the band

On the Size tab, set Width to Narrow and leave Height on Auto so the band grows to fit.

Centre the contents

On the Layout tab, set Alignment to Center.

To frame the band, switch to the Appearance tab and add a background, borders, or rounded corners.

Where to go next

On this page