Well

A compact content container with palette background, padding, and optional gradient.

Usage

Well wraps content in a padded panel with a solid background color — useful for callouts, inset content, sidebar-style boxes, or grouped blocks that should read separately from the page around them.

The block inserts with a heading and paragraph placeholder. Add any allowed inner blocks inside the well; spacing between nested blocks uses the theme's standard block gap.

Well is intentionally simpler than Section: solid color background, optional gradient overlay, padding, and rounded corners — no image, video, or pattern backgrounds. Use Section when you need full-width bands, transitions, or photo backgrounds.

Well Settings

Sidebar controls under Well Settings:

  • Background Color — palette fill for the panel (default gray)
  • Text ColorDark (default) or Light (reverse print) for readable copy on dark backgrounds. Reverse print cascades to nested blocks inside the well
  • Rounded — rounded corners on the panel (default on)
  • Padding — inner spacing from 0–24 (saved as quarter-rem steps; default 8 = 2rem)
  • Small Text — reduces body copy size inside the well
  • Add Gradient — subtle gradient overlay on top of the background color
    • Gradient Depth — intensity from 0–50% (step 5; default 10)
    • Gradient Direction — nine-position picker (upper-left through lower-right; default lower-right)

Allowed content

Inner blocks you can add inside a Well:

  • Heading, Paragraph, List, Buttons, Separator, Image
  • Columns, FAQ, Structured List, Socials, Marquee, Pills

Other Dirigible blocks are not allowed in this container. For a wider set of nested blocks, use Section instead.

Block width

Well supports Wide and Full alignment from the block toolbar. With no alignment set, the block follows default content width.

Tips

  • Enable Light text color when using a dark or saturated Background Color.
  • Add Gradient adds depth without switching to a full Section — tune Gradient Depth and Gradient Direction to match your layout.
  • Use Small Text for disclaimers, metadata, or compact FAQ-style content inside a well.
  • Nest FAQ or Structured List inside a Well when those blocks should sit on a tinted panel rather than the page background.
  • Increase Padding when content feels tight against the panel edges; decrease for dense layouts.

Settings

Well Settings

Background Color setting in the block editor sidebar
Background Color

Choose a background color for the well. This helps to visually distinguish the content within the well from the surrounding content.

Text Color setting in the block editor sidebar
Text Color

Select whether the text inside the well should be dark or light. This ensures good readability against the chosen background color.

  • Dark
  • Light
Rounded setting in the block editor sidebar
Rounded

Toggle this setting to apply or remove rounded corners to the well. Rounded corners can give the well a softer, more modern appearance.

Padding setting in the block editor sidebar
Padding

Inner spacing between the panel edge and content. Values from 0–24 map to quarter-rem steps (default 8 = 2rem).

Small Text setting in the block editor sidebar
Small Text

Toggle this setting to make the text inside the well smaller. This can be useful for less prominent information or to fit more text into a compact space.

Add Gradient setting in the block editor sidebar
Add Gradient

Adds a subtle gradient overlay on the background color — same gradient system used on Section color backgrounds. Enable before adjusting depth and direction.

Gradient Depth setting in the block editor sidebar
Gradient Depth

Control the intensity or depth of the gradient effect. A higher value will make the gradient more pronounced.

Gradient Direction setting in the block editor sidebar
Gradient Direction

Choose the direction from which the gradient effect will emanate. This allows you to control the visual flow and emphasis of the gradient.

  • upper-left
  • upper
  • upper-right
  • left
  • center
  • right
  • lower-left
  • lower
  • lower-rightdefault