Ergo Blocks

Last updated: Oct 13, 2026

Overview

This page documents every ACF block available for building pages on Ergo-based sites. Pick a block from the Index on the left to see its fields and any usage notes. Looking for what's changed recently instead? Check the "Update History" tab above.

Common Blocks

Hero Image Caption Text + Image Text Only Text – Two Columns Floating Image Footer CTA Logo Train Timeline

Hero

The Hero block is the standard page-top section: a title, strapline, and rich text, optionally paired with an image, background image, background video, a button, a color "screen" overlay, and a second content column. It renders full-width and is typically the first block on a page.

Fields

General

Title	Main hero heading, rendered as an h1.
Strapline	Small text above/near the title.
Text	Main body copy under the title.

Image

Image	Non-background hero image, placed per "Image Placement" below.
Image @2x	Retina version of the image.
Image Alt Text	Alt text for the hero image.
Image Caption - Title	Title shown alongside the image caption.
Image Caption - Text	Body text shown alongside the image caption.
Image URL	Overrides Image; relative to the child theme directory. Marked "not implemented" in the code.
Image Placement	One of: absolute-top-left-contain, absolute-top-right-contain, center-above-title, absolute-bottom-left-contain, absolute-bottom-right-contain.
Image Mobile	Used below the collapse width.
Image Mobile (Url)	Relative to the child theme; overrides "Image Mobile" if set.

Video

Video	MP4 background video; autoplays, muted, looped.

Button

Button Label	The button's visible text.
Button Href	The button's link destination.
Open in new window	"Open Link in New Window".

Background Image

Background Image	The hero's background image.
Background Image URL	Overrides Background Image; relative to the child theme directory.
Background Image Mobile	An image upload shown below the collapse width instead of the main background image. Overridden by Background Image URL - Mobile below, if that's also set.
Background Image URL - Mobile	A path (relative to the child theme) shown below the collapse width, instead of the main background image. Takes precedence over Background Image Mobile above when both are set.
Background Image Size	auto 100% (height 100% of hero, default), 100% auto (width 100% of hero), or cover (image covers the entire hero).
Background Image Size Mobile	Background-size value used for the mobile background image, below the collapse width; default "100% auto".
Background Image Position	e.g. "center top". Defaults to "center top".
Background Image Position - Responsive	Semicolon-separated breakpoint list, e.g. 1600: top right -400px; 1400 top right -500px.
Hide Background Image Less Than	Pixel width below which the background image (and video) is hidden.

Screen

When Should a Screen be Added?	Never, Always, or a pixel breakpoint (500–1500) below which the screen color overlay is shown.
Screen Background Color Presets	No Preset Screen, 10% / 20% / 30% Black.
Screen Background Color	Any CSS color; overrides the preset if one is selected.

Column Two

Column two only appears if there is a value for either its title or text field.

Column 2 Title	Heading for the second column.
Column 2 Text	Body copy for the second column.
Column 2 Width	Percentage width (0%–100%); default 6 (50%). Column 1 fills the remaining width.
Column 2 Vertical Alignment	Top or Center; default Top.
Column 2 Heading Type	h1, h2, or h3; default h2.

Advanced Block Settings

Section Class	Extra class(es) added to the outer <section>.
Content Class	Extra class(es) added to the column 1 content wrapper.
Collapse Width (Less than this value triggers mobile settings)	500–1500px; default 900. The breakpoint used throughout the block for mobile behavior: Background Image Mobile / Background Image URL - Mobile / Background Image Size Mobile, Image Mobile, Minimum Content Area Height - Mobile, and the hero's own mobile layout collapse.
Content Contain Width	600–1600px; default 1200.
Max Content Width	500–1000px. Changed from a free-text field to a select, alongside a fix so it actually gets applied (it was previously being silently overridden).
CSS	Raw CSS injected into the block's inline <style> tag.
HTML	Raw HTML, appears below the hero text content.
Height	Small, Small-Medium, Medium, Large, Extra Large, Extra Extra Large — each with a "no maximum height" variant. Default Large.
Minimum Content Area Height	200–800px, or Blank; default 400. Sets a min-height on the hero's content area. Choosing Blank removes the min-height rule entirely (e.g. to set it from a stylesheet instead); leaving the field unconfigured (only possible on a hero added before this field existed) falls back to the old hardcoded 400.
Minimum Content Area Height - Mobile	200–800px, or Blank; default 400. Overrides the above below the Collapse Width breakpoint. Blank actively clears it on mobile (`min-height: unset`) rather than just skipping the rule, since otherwise the desktop rule would still apply there too; leaving it unconfigured (only possible on a hero added before this field existed) lets mobile just inherit whatever the desktop setting resolved to.
Content Vertical Alignment	Top, Middle, or Bottom; default Top.
Collapsed Image Placement	Top or Bottom; default Top.
Left Column Width	25%–75%; default 50%.

Author Signature

An author signature: shows the current post's author with a bio and social links. Only renders if the author has both a first name and a bio filled in.

Not backed by block-level ACF fields — there's nothing to configure per block instance. All content is pulled from the post author's WordPress user profile fields (Profile Image, LinkedIn, X, Bio), so it's edited on the user's profile, not on the page.

Blog List

Blog Listing.

Fields

Read More Link Label	Overrides the text of the "read more" link on each post tile.
Read More Arrow Icon	None, Angle, Double Angle, or Chevron; adds an arrow icon after the read-more link.

Breadcrumbs

Adds a breadcrumbs block. No configurable fields — it automatically builds a trail from the page's hierarchy.

Caption

A standard caption section.

Fields

Title	Caption heading.
Text	Caption body copy.

Advanced Block Settings

Content Contain Width	900–1600px; default 1200.
Caption Max Width	200–600px; default 350.
Direction	Bottom Left (left aligned, line going up) or Bottom Right (right aligned, line going up); default Bottom Left.

Carousel

A standard carousel section.

Fields

Carousel Tiles	Repeater — each tile: Strapline, Title, Text, Link Url, Link Label, Link Class.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Tile Class	Extra class(es) added to each tile.

Comparison Table

A Comparison Table.

Fields

Title	Table heading.
Column Headers	Repeater — each entry: Column Title.
Row	Repeater — each row: Row/Group Label (only appears on mobile), and Columns (a nested repeater; each cell: Title, Icon — None or a circled checkmark).

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Contain Width	800–1500px; default 1200.
Mobile View	Use Tiles on Mobile — stacks each row into a tile below the collapse width.
Collapse Width (Increments of 100px)	Breakpoint below which the mobile view kicks in.
Max Width (Increments of 100px)	Overall content max width.
Cell Padding - Height (px)	Vertical cell padding; default "none".

Custom Block

Inserts a Pre-Built Custom Block: a way to drop in a reusable, hand-built block by path, optionally overriding some of its content.

Fields

Custom Block	Path to the custom block to include.
Strapline	Not always used — depends on the custom block.
Title	Not always used — depends on the custom block.
Text	Not always used — depends on the custom block.
Section Class	Extra class(es) added to the outer section.
Button Href	Not always used — depends on the custom block.
Button Label	Not always used — depends on the custom block.
Button Class	Not always used — depends on the custom block.

Title Override	Not always used — depends on the custom block.
Text Override	Not always used — depends on the custom block.
CSS Class	Not always used — depends on the custom block.

Advanced Block Settings

Options	Free-form textarea, meaning depends on the custom block being included.

FAQ

A FAQ block section.

Fields

Title	Section heading.
Text	Intro text above the FAQ list.
FAQ	Repeater — each entry: Question, Answer.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.
Max Width (Main Content Area)	700–1500px; default 1200.

File Download Listing

File Download Listing.

Fields

Files	Repeater — each entry: File Title, File (upload), Link (if set, overrides the uploaded file's URL), Image.

Advanced Settings

Section Class	Extra class(es) added to the outer section.
Columns	1, 2, or 3.
Collapse Width	800–1100px; default 900.

Footer CTA

Footer CTA.

Fields

Title	Heading text.
Strapline	Small text above/near the title.
Text	Body copy.
Button Href	The button's link destination.
Button Label	The button's visible text.
Background Image URL	Background image path.
Content Alignment	Center Content or Left-Align Content.
Column Left Width	33%–66%; only shown/used when Content Alignment is left-aligned; default 50%.
Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.

Full Bleed Image and Text

Image bleeds off the page, text is contained.

Fields

Title	Heading text.
Text	Body copy.
Image URL	Relative to the child theme.
Button Href	The button's link destination.
Button Label	The button's visible text.

Highlight Text+Image

A highlight text or testimonial block plus an image.

Fields

Text	Main highlighted text. If it already contains a <p> tag it's used as-is; otherwise it's wrapped in one.
Subtext	Smaller supporting text (e.g. attribution).
Image	Accompanying image.
Quotation Icon	None or Style 1 - White.
Content Class	Extra class(es) added to the content wrapper.

Layout

Image Placement	Left or Right; default Right. Flips which side the image and content box each appear on.
Content Box Size	4, 5, 6, or 7 (out of a 12-column grid); default 6. The image column gets whatever's left over (12 minus this).
Content Max Width	1000–1400px; default 1200. Expands the content box's outer edge so it lines up with an imaginary box of this width, centered on the whole section, instead of just using the content class's own flat max-width.
Max Image Size	None (default) or 500–1000px. Caps the image's rendered size, pinned to whichever side touches the content box.

Image

Image: a single standalone image section with a lot of placement/sizing controls.

Fields

Image	The image.
Image Alt Text	Alt text for the image.

Mobile

Image Mobile	Alternate image shown on mobile.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Image Class	Extra class(es) added to the image.
Section Max Width	Full Width, or 600–2000px; default 1800.
Image Size	Auto or 100% Width; default Auto.
Max Image Size (pixels)	Caps the image's rendered size.
Image URL (Overrides Image. Relative to child theme directory)	Overrides Image.
Image Link	Wraps the image in a link to this URL.
Collapse Width (Increments of 100px)	None, or 600–1600px.
Margin	CSS margin value.
Margin (Mobile)	Margin used below the Collapse Width.
Suppress Lazy Loading	Checkbox — disables lazy loading for this image.
Open Link in New Window	Checkbox — only relevant if Image Link is set.
Positioning Presets	None, Absolute Right, or Absolute Left.

Image Carousel

A standard image carousel section.

Fields

Carousel Tiles	Repeater — each tile: Image.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Tile Class	Extra class(es) added to each tile.
Hide Arrows	Checkbox — hides the prev/next arrows.
Carousel Height	CSS height value.
Image Sizing	Cover or Contain.

Image Columns

Columns of Images: up to 3 columns, each with its own title/text and a set of image tiles.

Not backed by an exported ACF field group JSON — the fields below are inferred directly from the render template's get_field()/get_sub_field() calls.

Fields

Section Class	Extra class(es) added to the outer section.
Column Title (×3)	Heading for each of the 3 columns.
Column Text (×3)	Body copy for each of the 3 columns.
Image (repeater, ×3 columns)	Each column has its own repeater of image tiles: Image Title, Image Text, Image, HTML.

Floating Image

Adds a floating image: an image absolutely positioned relative to a containing element.

Fields

Image	The image.

Advanced Settings

Section Class	Extra class(es) added to the outer section.
Image URL	If set, takes precedence over the uploaded image.
Contain Width	800–1500px.
Image Containing Element	Full Width or Content Width.
Image Position	Right, Left, or Other (custom CSS, e.g. "top: 0; right: -150px;").
Image Position (Custom)	Only shown when Image Position is "Other".
CSS	Raw CSS, minified and injected into the block's inline <style> tag.

Image Gallery

An Image Gallery, with two display styles:

Tiles (default): a grid of thumbnails. Clicking one opens it enlarged in a popup, with next/back arrows.
Slider: the current image is shown large, the full width of the block (capped by Content Max Width), with smaller thumbnails of the other images below it. Clicking a thumbnail jumps to that image. Previous/next arrows sit on the left and right of the large image and slide it in that direction (wrapping around at either end). The current image's caption is shown directly under the large image.

Fields

Style	Tiles or Slider; default Tiles. Existing galleries without this set render as Tiles.
Image	Repeater — each entry: Image, Caption. Used by both styles.
Columns	1, 2, 3, or 4; default 3. Tiles only.

Slider Settings

These two fields are only shown when Style is Slider.

Slider Image Fit	Cover (default) fills the frame and crops photos that don't match its shape. Contain always shows the whole photo, letterboxed on a light gray background.
Slider Aspect Ratio	Square (1:1), Standard (4:3, default), Classic photo (3:2), Widescreen (16:9), or Ultra-wide (21:9). The large image frame is always this fixed shape, so photos with different proportions don't make the layout jump as you move between them.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section. Both styles.
Content Max Width	600–1500px; default 1200. Both styles.
Image Height	Fixed (50–400px) or viewport-relative (10–35vw); default 250px. Tiles only.
Image Min Height	150–400px; default 150px. Tiles only.
Collapse Width	600–1400px. Tiles only.
Gallery Group	Groups multiple galleries on a page so the enlarged-image viewer's next/back arrows continue across all galleries sharing the same group. Tiles only (the slider doesn't use the popup viewer).

Image Mosaic – Two Images

Two Image Section.

Fields

Left Image	The left image.
Left Image Alt	Alt text for the left image.
Left Image Position (ie. right top)	CSS background-position style value.
Right Image	The right image.
Right Image Alt	Alt text for the right image.
Right Image Position (ie. right top)	CSS background-position style value.

Advanced Block Settings

Height	Include units (400px, 10vw, etc.).
Left Column Width	25%–75%; default 50%.
Collapse Width (No Units, 100 px increments)	Breakpoint below which the two images stack.
Gutter Between Images (px)	Spacing between the two images.
Suppress Contain	Checkbox — suppresses the default max width and mobile padding.

Image Mosaic – Three Images

Three Image Section.

Fields

Left Image	The left image.
Left Image Alt	Alt text for the left image.
Left Image Position (ie. right top)	CSS background-position style value.
Middle Image	The middle image.
Middle Image Alt	Alt text for the middle image.
Middle Image Position (ie. right top)	CSS background-position style value.
Right Image	The right image.
Right Image Alt	Alt text for the right image.
Right Image Position (ie. right top)	CSS background-position style value.

Advanced Block Settings

Height	Include units (400px, 10vw, etc.).
Left Column Width	25%–75%; default 50%.
Collapse Width (No Units, 100 px increments)	Breakpoint below which the images stack.
Gutter Between Images (px)	Spacing between the images.

Image Scroller

An Image Scroller.

Fields

Title	Section heading.
Images	Repeater — each entry: Image Title, Image.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Title Tag	h2, h3, or h4.

Transition Image

Adds a transition image: a full-width image with an optional color "screen" overlay and top/bottom background colors, similar in spirit to the Hero's screen behavior.

Fields

Image	The image.
Title	Heading text.
Contain Width	800–1500px.
Section Class	Extra class(es) added to the outer section.
Background Top Color	CSS color for the area above the image.
Background Bottom Color	CSS color for the area below the image.
Height (px, vw, etc..)	Section height.
Min Height (px, vw, etc...)	Section minimum height.

Screen

When Should a Screen be Added?	Never, Always, or a pixel breakpoint (500–1500) below which the screen color overlay is shown.
Screen Background Color Presets	No Preset Screen, 10% / 20% / 30% Black.
Screen Background Color	Any CSS color; overrides the preset if one is selected.

In Page Navigation

Inserts a Pre-Built Custom Block: a row/column of jump links to other sections of the same page.

Fields

Title	Section heading.
Navigation Items	Repeater — each entry: Link Label, Target (URL/anchor).

Advanced Block Settings

Style	Vertical or Horizontal; default Horizontal.
Section Class	Extra class(es) added to the outer section.
Section Max Width (Increments of 100)	Outer section max width.
Content Max Width (Increments of 100)	Inner content max width.
Collapse Width (Increments of 100px)	Breakpoint for mobile layout.

List

A standard list section.

Fields

List Items	Repeater — each entry: List Item Title, List Item Text.

Advanced Block Settings

Columns	1, 2, or 3; default 1.
Section Class	Extra class(es) added to the outer section.
List (UL) Class	Extra class(es) added to the <ul>.
Content Max Width (Increments of 100)	Inner content max width.

Logo Train

A logo train.

Fields

Title	Section heading.
Logo Train Images	Repeater — each entry: Logo Title, Logo Image.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Height (px)	Row height.
Title Tag	h2, h3, or h4.

Metrics

A place to display metrics.

Fields

Title	Section heading.
Text	Intro text.
Metrics	Repeater — each entry: Number (a "+" can be included; it's stripped for the count-up animation and re-added after), Label.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Collapse Width (Increments of 100px)	Breakpoint for mobile layout.
Section Max Width (Increments of 100)	Outer section max width.
Content Max Width (Increments of 100)	800–1800px; default 1200.

People

A listing of people. Pulls from the People post type; no repeater here.

Fields

Section Class	Extra class(es) added to the outer section.
Columns	1–6.
Content Max Width (Increments of 100)	Inner content max width.

Popup

A standard popup.

Fields

Behavior	Display On Load — checked by default.
Width	CSS width value.
Height	CSS height value; use "auto" to size to content.
Image	Optional image shown in the popup.
Footer Content	Rich text shown in the popup's footer.
Border Radius	0–25.
Close Icon Color	CSS color for the close icon.
Behavior (Once Per Day)	Only show once per day — unchecked by default.

Pull Quote

A standard pullquote.

Fields

Text	The quote text.
Subtext	Attribution/source text.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.
Section Container Width (Increments of 100)	Outer section max width.
Content Container Width (Increments of 100)	Inner content max width.

QA

A QA section.

Fields

QAs	Repeater — each tile: Question, Answer, Tile Class.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Contain Width	800–1600px; default 1200.

Scroll to Content

Scroll to content block: a static down-arrow that scrolls the page to the next section. No configurable fields — the markup is a fixed SVG arrow icon.

Table

A standard table section.

Column Titles & Settings

Column Settings	Repeater — each column: Column Heading Text, Merge Rows With Same Values, Center Text, Column Width (px).

Data

Row Data	Repeater (only shown once at least one column is defined above) — each row: Column 1 through Column 7 (plain text cells, matched up against the defined columns).

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Collapse Width (Increments of 100px)	Breakpoint for mobile layout.
Max Width (Increments of 100px)	Content max width.
Mobile View	Use Tiles on Mobile — renders each row as a tile below the collapse width.

Tabs

Tabs.

Fields

Tab Content	Repeater — each tab: Tab Label, Tab Title, Tab Text, Image.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.

Testimonial

A standard testimonial block.

Fields

Testimonial	Repeater — each entry: Testimonial Text, Testimonial Source (Name), Source Title, Testimonial Source Image.

Advanced Block Settings

Id	Custom id attribute for the section.
Section Class	Extra class(es) added to the outer section.
Section Container Width (Increments of 100)	Outer section max width.
Content Container Width (Increments of 100)	Content wrapper max width.
Content Max Width (Increments of 100)	Inner content max width.

Text – Accordion

An accordion block.

Fields

Title	Heading text.
Strapline	Small text above/near the title.
Text	Body copy, collapsible.

Button

Button Label	The button's visible text.
Button Href	The button's link destination.
Button Target	Link target attribute.

Advanced Block Settings

Id	Custom id attribute for the section.
Section Class	Extra class(es) added to the outer section.
Heading Tag	h2, h3, h4, or h5; default h3.
CSS	Raw CSS injected into the block's inline style tag.

Text + Image

A standard section with text and an image.

Fields

Title	Heading text.
Strapline	Small text above/near the title.
Text	Main body copy.

Image

Image	The image.
Image @2x	Retina version of the image.
Image Url (Overwrites image field)	Direct URL override.
Image Alt Text	Alt text for the image.
Image Position	Right or Left; default Right.
Image Width (integer, max width in pixels)	Caps the image's rendered width.
Image Caption - Title	Title shown alongside the image caption.
Image Caption - Text	Body text shown alongside the image caption.
Image Class	Extra class(es) added to the image.
Image Mobile	Alternate image shown on mobile.

Button

Button Label	The button's visible text.
Button Href	The button's link destination.
Button Target	Link target attribute.
Button Class	Extra class(es) added to the button.

Background Image

Background Image	Full-bleed background image behind the section.
Background Image Url (Overwrites background image field)	Direct URL override.
Hide Background Image Less Than (pixel dimension)	Breakpoint below which it's hidden.
Background Image Alignment - Horizontal	Right, Left, Maintain Midpoint, or None; default Right. Maintain Midpoint keeps the image's own center point fixed on the section's center as the browser resizes, instead of anchoring it to an edge.
Background Image Alignment - Vertical	Top, Bottom, or None; default Top.
Background Image Size	Cover, Contain, Height 100%, Image native dimensions, or None; default Height 100%.
Background Image Element	Outer Content Wrapper, Content, or Full Width.

Additional Content

Text - Introduction Text	Rich text shown before the main Text field.
HTML - Title	Raw HTML, appears near the title.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.
Title Tag	h1, h2, h3, or h4; default h2.
Title Link Url	Wraps the title in a link.
CSS	Raw CSS injected into the block's inline style tag.
HTML (Image Column)	Raw HTML, placed above the image.
Module Path (Image Column)	Path to an additional module rendered in the image column.
Content Vertical Alignment	Top, Middle, or Bottom; default Top.
Image Vertical Alignment	Top, Middle, or Bottom.
Image Horizontal Alignment	Left, Center, or Right.
Collapse Width (Increments of 100px)	Breakpoint below which the columns stack.
Collapsed Image Placement	Top or Bottom; default Top.
Left Column Width	25%–75% or a fixed 75–500px value; default 50%.
Section Max Width (Increments of 100)	None, or 500–2000px.
Content Max Width	Standard, None, or 500–2000px.
Gutter (Between Image and Content Columns)	0–100; default 50.
Suppress Contain (Suppresses the default behavior of setting a max width and mobile padding)	Checkbox.
CSS File Path (Relative to child theme)	Path to a .css file, relative to the child theme's root (e.g. `pages/about/testing/testing.min.css`); a leading slash is fine too. Its contents are minified and output at the start of the block's inline <style> tag, before the CSS field above. Only files that actually resolve inside the child theme are read — a path that tries to escape it (e.g. `../../wp-config.php`) is silently ignored.

Text Only

A standard section which only shows title and text.

Fields

Title	Heading text.
Strapline	Small text above/near the title.
Text	Main body copy.

Button

Button Label	The button's visible text.
Button Href	The button's link destination.
Button Target	Link target attribute.
Button Class	Extra class(es) added to the button.

Background Image

Background Image	Full-bleed background image behind the section.
Background Image Url (Used instead of Background Image)	Relative to theme folder.
Hide Background Image Less Than (pixel dimension)	Breakpoint below which it's hidden.
Background Image Aligment - Horizontal	Free-text alignment value.
Background Image Alignment - Vertical	Free-text alignment value.
Background Image Size	Contain or Cover; default Contain.
Background Image Element	Outer Content Wrapper, Content, or Full Width.

Additional Content

Sub Title	Secondary heading text.
Text - Introduction Text	Rich text shown before the main Text field.
HTML - Title (Appears above title)	Raw HTML, appears near the title.
HTML - Body (Appears below body text)	Raw HTML, appears right after the main Text field (before the button, if any).

Advanced Block Settings

Id	Custom id attribute for the section.
Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.
Content Class (Title Block Section)	Extra class(es) added to the title area.
Content Class (Text Section)	Extra class(es) added to the text area.
Heading Tag	h1, h2, h3, or h4; default h2.
CSS	Raw CSS injected into the block's inline style tag. Now a multi-line text area in the editor rather than a single-line field.
Content Vertical Alignment	Top, Middle, or Bottom; default Top.
Section Container Width (Increments of 100)	Outer section max width.
Content Container Width (Increments of 100)	Content wrapper max width.
Content Max Width (Increments of 100)	Inner content max width.
Suppress Contain (Suppresses the default behavior of setting a max width and mobile padding)	Checkbox.
CSS File Path (Relative to child theme)	Path to a .css file, relative to the child theme's root (e.g. `pages/about/testing/testing.min.css`); a leading slash is fine too. Its contents are minified and output at the start of the block's inline <style> tag, before the CSS field above. Only files that actually resolve inside the child theme are read — a path that tries to escape it (e.g. `../../wp-config.php`) is silently ignored.

Text – Two Columns

Two columns of text, each with its own title, text, button, and optional embedded custom block.

Fields

Title	Overall section heading.
Strapline	Small text above/near the title.

Column 1 / Column 2

Each column repeats the same set of fields (suffixed _1 / _2):

Title	Column heading.
Strapline	Small text above/near the column title.
Text	Column body copy.
Button Label	The button's visible text.
Button Href	The button's link destination.
Button Target	Link target attribute.
Button Class	Extra class(es) added to the button.
Button Data Attributes	e.g. data-target="somevalue" data-value="somevalue".
Block	Includes a custom block; provide the URL relative to the child theme.

Background Image

Background Image	Full-bleed background image behind the section.
Background Image Url (Overwrites background image field)	Direct URL override.
Hide Background Image Less Than (pixel dimension)	Breakpoint below which it's hidden.
Background Image Alignment - Horizontal	Right, Left, Maintain Midpoint, or None; default Right. Maintain Midpoint keeps the image's own center point fixed on the section's center as the browser resizes, instead of anchoring it to an edge.
Background Image Alignment - Vertical	Top, Bottom, or None; default Top.
Background Image Size	Cover, Contain, Height 100%, Image native dimensions, or None; default Height 100%.
Background Image Element	Outer Content Wrapper, Content, or Full Width.

Advanced Block Settings

Id	Custom id attribute for the section.
Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.
Heading Tag	h1, h2, h3, or h4; default h2.
Section Container Width (Increments of 100)	Outer section max width.
Content Container Width (Increments of 100)	700–1800px; default 1200.
Content Max Width	None (default) or 400–1200px (increments of 100). Caps the width of the inner content wrapper (header plus both columns), nested inside the outer Content Container Width above.
Left Column Width	8%–91%; default 50%.
Collapse Width	400–1300px.
Horizontal Alignment - Left Column	Left, Center, or Right.
Vertical Alignment - Left Column	Top, Middle, or Bottom.
Horizontal Alignment - Right Column	Left, Center, or Right.
Vertical Alignment - Right Column	Top, Center, or Bottom.

Tile Mosaic

A tile mosaic section: a fixed 3-tile arrangement (two horizontal tiles plus one vertical tile), each configured on its own tab in the editor.

Fields

Tile 1 & Tile 2 (Horizontal)

Each of these two tiles repeats the same fields (suffixed _1 / _2):

Title	Tile heading.
Text	Tile body copy.
Image	Tile image.
Image Placement	Left or Right; default Left.
Link Url	The tile's link destination.
Link Label	The tile's link text.
CSS Class	Extra class(es) added to the tile.
Tile Behavior	Make Entire Tile Clickable — checkbox.

Tile 3 (Vertical)

Same fields as above (suffixed _3): Title, Text, Image, Link Url, Link Label, CSS Class, Tile Behavior.

Section Content

Section Title	Overall section heading.
Section Strapline	Small text above/near the section title.
Section Text	Overall section body copy.
Section Bottom Image	Image shown below the tiles.
Bottom Image Placement	Section Wrapper or Content Container.

Advanced Block Settings

Vertical Column Alignment	Left or Right; default Left.
Section Class	Extra class(es) added to the outer section.
Section Max Width (Increments of 100)	Outer section max width.
Content Max Width (Increments of 100)	Inner content max width.

Tiles

Tiles: a grid of repeatable tiles. The Tile Type setting changes which sub-fields are shown/used per tile (Simple, General, or Person).

Fields

Tile Type	Simple, General, or Person; default Simple — controls which of the tile sub-fields below are shown.
Tiles	Repeater — see sub-fields below.

Tiles — common sub-fields

Title (not used on "people" tile types)	Tile heading.
Image	Tile image.
Text	Tile rich text.
Link	The tile's link destination.
Link Label	The tile's link text.
Link Class	Extra class(es) added to the link.
Link Target	Open in Same Window or Open in New Window; default same window.
Click Behavior	Entire Tile Clickable — checkbox.
Data Attributes	Raw data-* attributes to add to the tile.
Image Url (Theme-relative path, used instead of Image)	e.g. `images/foo.webp`.
Background Image	Applied as this tile's own CSS background-image (not shown as an <img>).
Advanced — CSS Class	Extra class(es) added to this tile.
Advanced — Width (Span)	1–3; how many tile-widths this tile spans.

Tiles — Person type only

Name	Person's name.
Professional Title	Job title.
Company Name	Company name.
Modal – Use Modal	Open modal if user clicks on tile — checkbox.
Modal – Modal Text	Rich text shown in the modal.
Modal – Modal Image	Image shown in the modal.

Tiles — General type only

Strapline	Small text above/near the tile title.
Sub Title	Secondary heading text.
Header – Header PHP File	If found, its contents are inserted at the top of the tile.
Footer – Footer Text	Rich text shown in the tile's footer.
Footer – Button Href	Footer button link destination.
Footer – Button Label	Footer button text.

Section Content

Section Title	Overall section heading.
Section Strapline	Small text above/near the section title.
Section Text	Overall section body copy.
Section Bottom Image	Image/file shown below the tiles.
Bottom Image Placement	Section Wrapper or Content Container.

Background Image

Applies to the whole section, not an individual tile (see the Background Image field under each tile's own sub-fields for that). Only the image itself is wired up for this block — unlike Hero/Text + Image/Text – Two Columns, there's no alignment or "hide below this width" option here.

Background Image	Full-bleed background image behind the whole section.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Class	Extra class(es) added to the content wrapper.
Tile Class	Extra class(es) added to every tile.
Tile Heading Tag	h1, h2, h3, or h4; default h3.
Render Image as Background	Checkbox.
Render as Background - Image Height	Include units; "none" for no height.
Render image as background size	Cover or Contain; default Cover. Only shown when the above is checked.
Image Sizing	Keep Image Within Container — checked by default.
CSS	Raw CSS injected into the block's inline style tag.
Collapse Width (Increments of 100px)	Breakpoint for mobile layout.
Section Max Width (Increments of 100)	Outer section max width.
Content Contain Width (Increments of 100) (Content stays centered)	Keeps content centered within this width.
Content Max Width	600–1300px; default 1200.
Columns	1–5; default 3.
Column Gap	Gap between columns.
Row Gap	Gap between rows.
Image / Icon Placement	Above or Left; default Above.
Image Column Width	50–300; only shown when Image/Icon Placement is Left.
HTML - Above Title	Raw HTML placed above each tile's title.
Tile Clickable	Make entire tile clickable — checkbox.

Tiles – Horizontal

Tiles - Horizontal: a row of tiles laid out with a fixed-width left label column.

Fields

Section Title	Overall section heading.
Tiles	Repeater — each tile: Title, Strapline, Image, Text, CSS Class, Link, Link Label, Link Class, Data Attributes, ID.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Tile Class	Extra class(es) added to every tile.
Render Image as Background	Checkbox.
CSS	Raw CSS injected into the block's inline style tag.
Collapse Width (Increments of 100px) (collapses tile columns)	400–1600px.
Collapse Width - Tile (Collapses the image and content within a tile)	400–900px.
Section Contain Width (Increments of 100)	Outer section max width.
Content Contain Width (Increments of 100)	Inner content max width.
Content Max Width (Increments of 100)	Content wrapper max width.
Columns	1–5.
Column Left Width	0–500; default 75. Width of the label column.
Column Left - Padding Right	5–25; default 25.
Column Gutter	10–100; default 40.
Tile Clickable	Make Entire Tiles Clickable — checkbox.

Timeline

A timeline section.

Timeline Elements

Timeline Elements	Repeater — each entry: Title, Text, Date, Element Position (Right or Left; default Right).

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Collapse Width (Increments of 100px)	Breakpoint for mobile layout.
Section Max Width (Increments of 100)	Outer section max width.
Content Max Width (Increments of 100)	Inner content max width.
Column Left Width	100–300; default 125. Width of the date/rail column.

Two Columns

Two Columns: a text-and-image layout, similar to Text + Image but with two independent text columns alongside the image.

Not backed by an exported ACF field group JSON — the fields below are inferred directly from the render template's get_field() calls.

Fields

Column 1 / Column 2

Each column repeats the same set of fields (suffixed _1 / _2):

Title	Column heading.
Strapline	Small text above/near the column title.
Text Intro	Rich text shown before the main Text field.
Text	Column body copy.
Text Align	Text alignment for this column.

Image

Image	The image.
Image Position	Right or Left.
Image @2x	Retina version of the image.
Image Alt Text	Alt text for the image.
Image Mobile	Alternate image shown on mobile.
Image Max Width	Caps the image's rendered width, in pixels.
Image Caption Title	Title shown alongside the image caption.
Image Caption Text	Body text shown alongside the image caption.
Image Class	Extra class(es) added to the image.
Image Set Maxwidth	Checkbox — controls whether the image gets a default max-width: 100% rule.

Background Image

Background Image	Full-bleed background image behind the section.
Background Image Hide Less Than	Breakpoint below which it's hidden.
Background Image Alignment - Horizontal	Default Right.
Background Image Alignment - Vertical	Default Bottom.

Advanced Block Settings

Section Class	Extra class(es) added to the outer section.
Content Vertical Alignment	Vertical alignment of the two text columns.
Collapsed Image Placement	Top or Bottom.
Left Column Width	25%–75%; default 50%.
HTML Image	Raw HTML, placed near the image.
Section Max Width	Outer bounds of the page; default 1800.
CSS	Raw CSS injected into the block's inline style tag.
Collapse Width	Breakpoint below which the columns stack.
Max Width	Content max width, or "standard".

Video

A standard section which only a video.

Fields

Cover Image	Poster/cover image shown before the video plays.
Vimeo Video Id (ie: 877473729)	The Vimeo video's numeric id.

Updates

Tiles: new fields & background image fixes

Oct 13, 2026

New fields: Added "Image Url" (theme-relative path, used instead of the Image field) and a per-tile "Background Image" (applied as that tile's own CSS background instead of an <img>) to each tile's sub-fields, plus a section-wide "Background Image" field for the block as a whole.

Bug fix: The per-tile Background Image wasn't reliably showing on tiles that open a modal or are themselves a link (entire-tile-clickable) -- those tiles now get the same stable per-tile class as plain tiles, which the background-image CSS is scoped to.

Highlight Text+Image: bug fix

Oct 9, 2026

Fixed a gap that could appear between the image and content box when Image Placement is Left and Max Image Size is set -- the content box now gets a minimum height matching how tall a Max Image Size-wide image actually is, so the row is always tall enough for the image to reach its full configured width.

Highlight Text+Image: layout & sizing options

Oct 7, 2026

Image Placement: Added a Left/Right option (default Right) to flip which side the image and content box appear on.

Content Box Size: The content column's width (previously a fixed half) is now a 4–7 (out of 12) field, default 6; the image column takes whatever's left over.

Max Image Size: Added a None/500–1000px cap on the image's rendered size, pinned to whichever side touches the content box, instead of it always being full-bleed.

Content Max Width: Added a 1000–1400px field (default 1200) so the content box's outer edge can line up with an imaginary centered box of that width, instead of only using its own flat max-width.

Text – Two Columns: Content Max Width & bug fix

Oct 2, 2026

Content Max Width: Added a "Content Max Width" field (None, or 400–1200px) that caps the width of the inner content wrapper -- header plus both columns -- nested inside the existing Content Container Width.

Bug fix: Fixed a fatal error that this new field's default value ("None") triggered in the mobile-padding calculation that every block's Content Max Width-style field feeds into.

Hero, Text + Image, Floating Image, & Text – Two Columns: block updates

Oct 1, 2026

Hero — Mobile background image: Added a "Background Image Mobile" image-upload field, shown below the Collapse Width breakpoint instead of the main background image. The existing "Background Image URL - Mobile" text field still works the same way and takes precedence if both are set. Also added a "Background Image Size Mobile" field (default "100% auto") so the mobile background-size no longer has to match the desktop one.

Hero — Minimum content height: The hero's content area min-height (previously hardcoded to 400px) is now a "Minimum Content Area Height" select field (200–800px, or Blank to remove the rule entirely), plus a separate "Minimum Content Area Height - Mobile" field for below the Collapse Width breakpoint.

Hero — Collapse Width: That breakpoint is now its own explicit field in the block's settings (500–1500px, default 900) rather than only being inherited with no way to change it.

Text + Image — Maintain Midpoint alignment: Added a "Maintain Midpoint" option to the Background Image Alignment - Horizontal field. Instead of anchoring the image to an edge, it keeps the image's own center point fixed on the section's center as the browser resizes.

Text + Image — Bug fix: Fixed the "Hide Background Image Less Than" setting not actually hiding the background image below that breakpoint in some cases.

Floating Image — CSS field: Added a "CSS" field so you can write raw CSS directly in the block's settings; it's minified and injected into the block's own inline style tag, same as the CSS fields on other blocks.

Text – Two Columns — Background image: Added the same Background Image field set used by Hero, Text + Image, and Text Only (image, URL override, hide-below breakpoint, horizontal/vertical alignment including Maintain Midpoint, size, and which element it's applied to).

Text Only & Text + Image: block field updates

Sep 30, 2026

CSS File Path field: Added a "CSS File Path (Relative to child theme)" field to both blocks. Point it at a .css file in the child theme and its contents get minified and included at the start of the block's inline style tag, so you can ship a page-specific stylesheet alongside these blocks without hand-writing CSS into the Advanced Block Settings CSS field. Paths that try to escape the child theme folder are ignored.

HTML - Body field (Text Only): Added an "HTML - Body (Appears below body text)" field, rendered right after the main Text field (before the button, if any). The existing HTML field was relabeled to "HTML - Title (Appears above title)" to make the two easy to tell apart. The CSS field is now a multi-line text area in the editor instead of a single-line field.

Image Gallery: Slider style

Sep 22, 2026

Added a Slider style alongside the existing Tiles style, with a fixed-shape large image (Slider Image Fit and Slider Aspect Ratio settings), thumbnails below, and previous/next arrows that slide the image.

Hero: "No Maximum Height" options

Sep 17, 2026

Fixed the "No Maximum Height" choices in the Hero's Height setting (Small through Extra Extra Large) so they truly remove the height cap. The hero now keeps scaling with the width of the screen instead of stopping at a fixed maximum height.

Hero: Max Content Width bug fix

Sep 16, 2026

Fixed the Max Content Width setting so it actually applies -- it was being silently overridden by an unrelated default elsewhere in the block. Also changed it from a free-text field to a select (500–1000px), so only valid values can be entered.

Ergo Blocks

Index

Overview

Common Blocks

Hero

Fields

General

Image

Video

Button

Background Image

Screen

Column Two

Advanced Block Settings

Author Signature

Blog List

Fields

Breadcrumbs

Caption

Fields

Advanced Block Settings

Carousel

Fields

Advanced Block Settings

Comparison Table

Fields

Advanced Block Settings

Custom Block

Fields

Archive

Advanced Block Settings

FAQ

Fields

Advanced Block Settings

File Download Listing

Fields

Advanced Settings

Footer CTA

Fields

Full Bleed Image and Text

Fields

Highlight Text+Image

Fields

Layout

Image

Fields

Mobile

Advanced Block Settings

Image Carousel

Fields

Advanced Block Settings

Image Columns

Fields

Floating Image

Fields

Advanced Settings

Image Gallery

Fields

Slider Settings

Advanced Block Settings

Image Mosaic – Two Images

Fields

Advanced Block Settings

Image Mosaic – Three Images

Fields

Advanced Block Settings

Image Scroller

Fields

Advanced Block Settings

Transition Image

Fields

Screen

In Page Navigation

Fields

Advanced Block Settings

List

Fields

Advanced Block Settings

Logo Train

Fields