Groupings
A grouping is a named list of items shown as a block on a record’s page: “Amenities”, “Practice areas”, “Photos”, “Agendas”. Every item has the same shape — an icon or an image, a heading, supporting text and an optional link — and the grouping decides how the items are laid out and where the block sits. Items are typed in per record, or pulled in automatically from related records.
How to define a grouping
Section titled “How to define a grouping”- Open Post Runtime → Post Types and select Groupings on the type’s row, then Add New.
- Enter a Key (lowercase letters, numbers, underscores) and a Label. The label is the heading shown above the block.
- Choose a Default variant and a Default position.
- Choose a Source mode and, under Field requirements, which parts each item must have.
- Select Define grouping.
Editors fill in items in the Post Runtime Groupings box on each record. On that record they can also change the grouping’s Position and Variant; Default keeps the type’s setting. A grouping with no items is not shown.
Variants
Section titled “Variants”| Variant | What it shows |
|---|---|
| Compact grid | Icon and heading, several per row. Images are not shown: set an icon on each item, or a Default icon on the type. |
| Card grid | Cards with an icon or image, heading and supporting text. |
| Featured card | One prominent card with an image, heading and text. Meant for a single item: its Max items must be 1 or blank. |
| Horizontal row | Icon and heading as inline chips, for at-a-glance facts. Images are not shown. |
| Gallery | A photo grid (three across on desktop, two on phones) that opens a lightbox. Only images show; the heading becomes an optional caption. |
An item has either an icon or an image, not both. Icons come from the
built-in set of 53 or any Iconify code such as mdi:home; an Iconify icon is
fetched from the Iconify service by the visitor’s browser.
For a gallery, Gallery tile aspect ratio sets the crop of the tiles (16:9, 4:3, 1:1 or 4:5); the lightbox always shows the whole image. Items without an image are kept but not shown, and + Add images in the edit box adds several photos at once. Set alt text on the images in the media library: the gallery reads it from there.
Positions
Section titled “Positions”| Position | Where the block sits |
|---|---|
| Above main content | Before the text you write in the editor. |
| Below main content | After it. |
| Sidebar (sticky on desktop, stacked on mobile) | In a side column. Placing anything in the sidebar switches the page to a two-column layout. |
An item links with Link: start typing a record or page name to pick
it, or paste an address (https://, /path, #anchor, tel:, mailto:).
A picked record is stored by its ID, so the link survives a change of
address or domain; the box shows Linked to and the record’s name, and
warns if that record has been deleted.
A linked item becomes one link over the whole card, with a small arrow. The link’s name for screen readers is the item’s heading. There is no separate link text or new-tab option. Gallery items do not link; the tile opens the lightbox.
Sources
Section titled “Sources”| Source mode | Where the items come from |
|---|---|
| Manual — items entered per post | Typed in on each record. |
| Child posts | The record’s child records, in page order then by title. The type must be Hierarchical. |
| Taxonomy match | Other records of the same type that share a term in the chosen Taxonomy slug, newest first. |
| Meta match | Records whose stored value matches something about this record, newest first. |
Automatic items use each matched record’s title as the heading, its excerpt (or the start of its content) as the supporting text, its featured image, and a link to it. In a gallery, each matched record’s featured image becomes a tile.
Item limit caps an automatic source; Exclude the current post from results is on by default. Without an item limit, the grouping’s Max items applies, and without that, six items.
Meta match and reverse lookups
Section titled “Meta match and reverse lookups”Meta match takes a Post field key or a Post-meta key — one, not both — and finds other records of the same type with the same value for it: “more listings from this agent” when every listing stores an agent ID.
It can also look the other way: from a parent record to the records that
name it. Choose the type to search in Records of type and what its field
must equal in Match against. Through the connector, the same source sets
post_type, field_key and match_against:
match_against | Matches records whose field equals |
|---|---|
same_key | This record’s own value for the same field (the default) |
current_title | This record’s title |
current_slug | This record’s slug |
current_id | This record’s ID |
For example, an Agent page lists its Listings with
{"type": "meta_match", "post_type": "listing", "field_key": "agent", "match_against": "current_title"},
where each listing’s agent text field holds the agent’s name. Use
current_id with a hidden field when names may change.
Options
Section titled “Options”| Option | What it does | Default |
|---|---|---|
| Max items | Most items per record, up to 100. Featured card needs 1 or blank. Through the connector, 0 or null also means no cap. | No cap |
| Heading is required | Each item needs a heading. Ignored for a gallery. | On |
| Supporting text is required | Each item needs supporting text. | Off |
| Link is required | Each item needs a link. | Off |
| Icon or image is required | Each item needs an icon or image. | Off |
| Description | A note for editors; not shown on the site. | Blank |
Limits and common problems
Section titled “Limits and common problems”- Removing a grouping keeps the items. Items saved on records stay; they show again if you define a grouping with the same key.
- An automatic grouping is empty. A taxonomy match needs the record to have a term in that taxonomy; a meta match needs a value to compare; only published records are matched.
- Images do not show in a compact grid or horizontal row. Those layouts show icons only. Switch the record’s Variant to Card grid or Featured card.