Advanced Section is a container block that accepts any inner blocks and adds a rich layer of background, overlay, border, and layout controls on top of WordPress's native layout system. Use it wherever a Group block isn't enough — hero sections, feature rows, CTA bands, and any section that needs a custom background, a flex or grid arrangement, or precise height control.
How to add
Open the block inserter, switch to the Axiom Blocks category, and click Advanced Section. The block drops in empty, ready for inner blocks. Add any blocks inside it — Headings, Paragraphs, Buttons, Columns, or other Axiom blocks.
Layout
Layout is the first control in Settings and it decides how the section arranges its direct children. The rest of the panel changes to match the mode you pick.
Constrained
The default, and the same behavior earlier versions had: inner blocks stack vertically at the theme's content width.
- Vertical — Top, Center, Bottom — aligns content along the vertical axis within the min-height area
- Horizontal — Left, Center, Right — aligns content along the horizontal axis
Flex
Arranges direct children in a flex row or column — the way you'd build a feature row or a logo strip without reaching for Columns.
- Direction — row or column
- Wrap — allow children to wrap onto new lines
- Justify — distribution along the main axis
- Align — alignment along the cross axis
- Gap — space between children, per device
Grid
Arranges direct children in an even grid.
- Columns — number of columns, per device
- Align items — cross-axis alignment within each cell
- Gap — space between cells, per device
Stack below
Flex and Grid both get a Stack below value. Below that width the section collapses to a single column, so a three-across feature row becomes a readable stack on phones. This is scoped to the individual block, so two sections on the same page can stack at different widths.
Min height
Sets the minimum height of the section, with a unit switcher for px, vh (viewport height), or rem. A hero set to 100vh fills the screen. Min height is a per-device control — set it once for desktop and override it on tablet or mobile using the device switcher at the top of the control.
Background
Background lives in Styles → Container and opens in its own popover. The Type selector switches between three modes.
Color
A solid background color. Leave it empty to inherit the page background.
Gradient
Builds a CSS gradient in the sidebar — Linear (angle-based) or Radial (center-out), with color stops you can add and position individually.
Image
Picks a background image from the media library.
- Size — Cover (fill, may crop), Contain (fit fully, may letterbox), Auto (natural size)
- Focal point — drag the crosshair on the preview to set the background position
- Repeat — No repeat, Repeat, Repeat X, Repeat Y
- Attachment — Scroll (moves with page) or Fixed (stays put as content scrolls). Hidden when Parallax is on, since the two conflict.
Overlay
An overlay sits between the background and the inner content — use it to darken an image so text stays readable, or to wash a color over a gradient. It's part of the same Background popover.
- Type — Color or Gradient
- Opacity — 0–100%; at 0 the overlay is invisible regardless of color
- Blend mode — Normal, Multiply, Screen, Overlay, Darken, Lighten
Parallax
Available only when the background type is Image and an image is selected. Parallax speed runs 0–100%; 20–40% is a safe starting range.
The sidebar at a glance
The block sidebar is split into two tabs. Settings is what the section does; Styles is how it looks, organised by the parts you can see.
| Tab | Section | Covers |
|---|---|---|
| Settings | Layout | Layout mode, min height, alignment, flex/grid options, gap, stack below |
| Settings | Advanced | Visibility, Position, anchor, CSS class |
| Styles | Container | The section box itself |
| Styles | Spacing | Padding and margin on the outer wrapper |
Styling
| Part | Rows |
|---|---|
| Container | Background (color / gradient / image + overlay + parallax), Border, Radius, Shadow, Size — Width and Max width, per device |
| Spacing | Padding and margin on the outer block |
The block supports Wide and Full alignment from the toolbar and an HTML anchor.
HTML output
CSS custom properties
Layout, background, and border values are surfaced as custom properties on the wrapper so your theme stylesheet can read or override them.
| Property | Controls |
|---|---|
--ab-sec-bg | Background layer (color, gradient, or image URL) |
--ab-sec-attach | Background attachment |
--ab-sec-overlay-bg | Overlay layer (color or gradient string) |
--ab-sec-overlay-opacity | Overlay opacity (0–1) |
--ab-sec-overlay-blend | Overlay blend mode |
--ab-sec-parallax / --ab-sec-parallax-speed | Parallax flag and speed |
--ab-sec-bs / --ab-sec-bc / --ab-sec-bw | Border style, color, width (per-side as --ab-sec-bw-top etc.) |
--ab-sec-radius | Corner radius (per-corner variants also emitted) |
--ab-sec-shadow | Box shadow |
--ab-sec-w / --ab-sec-mw | Width and max width |
--ab-sec-ta | Content text alignment |
--ab-sec-fd / --ab-sec-fw / --ab-sec-jc / --ab-sec-ai | Flex direction, wrap, justify, align |
--ab-sec-cols | Grid column count |
--ab-sec-gap | Gap between children (flex and grid) |
--axiom-blocks-section-min-h | Minimum height |
--axiom-blocks-section-justify | Vertical content alignment |
--axiom-blocks-section-align | Horizontal content alignment |