Slowly
The builderBlocks

Popover

Rich content in a small panel, opened from a button.

The Popover block shows content in a small panel anchored to a button, opening beside or below it on click. It is lighter than a modal, the page stays put behind it, which suits menus, extra detail, and small forms.

Adding one

  1. Select the section or container to hold it.
  2. Open the inserter and search "popover".
  3. Pick the Popover block.

The trigger button and the panel are both yours to style. Add any blocks inside the panel, headings, text, a form, a list of links.

Settings

In the popover's own panel. Appearance lives in the shared design panel.

SettingWhat it doesReach for it when
TriggerHow the panel opens: click (default) or hoverHover suits tooltip-style hints; click is better for anything interactive inside the panel
PlacementWhich side of the trigger the panel appears onThe panel opens beside the trigger by default; change this if the panel clips the viewport edge
ShiftKeeps the panel in view by nudging it along its axis (on by default)Leave on; turn off only if a fixed position is required
FlipMoves the panel to the opposite side when it would overflow (on by default)Leave on; turn off if the flip behaviour conflicts with your layout

Styling

The trigger button and the panel are separate elements inside the block, so style them separately in the shared design panel. The panel's open state is a good candidate for a transition in the states panel.

Accessibility

The trigger button needs a label that describes what it opens, so a screen-reader user knows what to expect before activating it. If the trigger has no visible text (an icon only), add an aria-label in the block's HTML attributes. Keep interactive elements inside the panel keyboard-reachable: anything a mouse user can click, a keyboard user should be able to tab to and activate.

On this page