Posts Blocks
| Field | Value |
|---|---|
| Audience | public |
| Page type | reference |
| Area | sg-builder |
| Updated | 2026-05-14 |
SG-Builder blocks for post-shaped content — archive, post detail primitives, navigation, and related items.
Posts Blocks is the SG-Builder component category for surfacing or interacting with post-shaped content. Posts in SGEN include blog posts, news posts, and any custom record type configured as post-shaped. The Posts category primarily provides the blocks operators use to compose post detail page templates (Post Title, Content, Featured Image, Navigation, Related Items) plus a Posts Archive block for listing pages. This page is the Reference definition.
What is this for?
Read this page when you want the structural definition of the Posts block set — what each block does and how it pairs with the admin Blogs module.
Good use cases
- You are scoping a blog or news section and need the post-block inventory.
- You are explaining to a stakeholder how SG-Builder surfaces post content.
- You hit a "how do recent posts appear?" question and want the model laid out.
What NOT to use this for
- Step-by-step procedures — open the relevant Guide.
- Per-trait configuration — Components Reference.
- Per-release shipped change — open What's New or Changelog.
- Post administration — open the admin Blogs module.
How this connects to other features
- Components — parent Reference.
- Basic Blocks — foundational blocks Posts blocks compose with.
- Ecommerce Blocks — sibling category.
- Extra Blocks — sibling category.
Definition
Posts Blocks are the SG-Builder components that surface post-shaped content on pages. The category is primarily oriented toward post detail page composition — individual primitives (Post Title, Content, Featured Image, Navigation, Related Items) that assemble the layout of a single post. The Posts Archive block handles listing pages.
The defining property is post-shaped consumption. Posts blocks read from the admin Blogs module's post records and surface them on pages.
Purpose
The purpose of this page is to define the Posts block set as a Reference layer. It enumerates the blocks and explains how each pairs with post records.
Scope
This page covers Posts Blocks at the Reference level.
The page covers:
- The block inventory in the Posts category (Posts Archive for listing pages; Post Title / Content / Featured Image / Navigation / Related Items for detail page templates).
- Per-block role.
- The relationship to the admin Blogs module.
- Per-trait configuration — Components Reference.
- Post administration — SG-Admin Blogs Reference.
- Step-by-step procedures — Guides.
Block inventory
The Posts block set is split between the listing surface (Posts Archive) and the detail-page surface (the primitives below).
Posts Archive
A listing block that displays multiple posts. Configurable post count, sort order, and filter (by tag, by category, by date range). Use this block on blog index and category pages.
Post Title
Displays the current post's title. Used on post detail page templates.
Content
Displays the current post's body content. The block renders the full post body as authored in the admin Blogs. Used on post detail page templates.
Featured Image
Displays the current post's featured image. Semantically distinct from a "featured post" — this block surfaces the image field on the current post record. Used on post detail page templates.
Navigation
Post-to-post navigation block. Renders previous-post and next-post links, enabling readers to move between posts in sequence. Used on post detail page templates.
Related Items
Displays posts related to the current post. Configurable count and relationship rule (by tag, by category). Used on post detail page templates.
SG-Builder · Posts blocks · Rendered
Recent posts (3-card grid)
Caching, scaling, and architecture groundwork
Caching coverage expands across public pages...
Application efficiency and media reliability
Application-level optimization reduces public-page overhead...
Traefik migration scripts for managed instance groups
Migration scripts move Traefik infrastructure...
Pairing with SG-Admin Blogs
Posts blocks read from the admin Blogs module. The relationship is consumer / producer: SG-Admin Blogs is where posts are administered (created, edited, tagged); SG-Builder Posts blocks surface them on pages.
Consequences
- Editing a post in the admin Blogs propagates to every Posts block that surfaces it — both Posts Archive listings and detail-page blocks.
- Filter dimensions (tag, category) in Posts Archive rely on tags and categories administered in the admin Blogs.
- Posts Archive and the detail-page primitives work together: Archive lists the posts; each post's detail page is composed from the primitive set (Post Title, Content, Featured Image, Navigation, Related Items).
Constraints and boundaries
Posts Blocks is a Reference area for the post-content block set.
Use this Reference for:
- Understanding what Posts blocks exist.
- Confirming the relationship to the admin Blogs.
- Post administration — SG-Admin Blogs Reference.
- Per-trait configuration — Components Reference.
- Step-by-step procedures — Guides.
Public boundary
This page is intentionally public-safe.
Examples
Example 1 — Operator places a posts listing on the homepage
The operator drags Posts Archive to the homepage. Configures count = 3, sort = date descending. The block surfaces the 3 most recent posts; new posts in the admin Blogs propagate automatically.
Example 2 — Operator builds a category listing page
The operator places Posts Archive configured to filter by category. The page shows posts in that category. Adding new posts tagged with that category surfaces them automatically.
Example 3 — Operator builds a post detail template
The operator opens a post in SG-Builder and composes the detail layout: Featured Image at top, Post Title, Content, Navigation (previous / next links), Related Items at bottom. Saving the template applies it to subsequent posts of the same type.
Documentation guidance
Use this page as the structural definition for the Posts block set. Per-component configuration detail lives in the Components Reference.
Reading order
Open this page when scoping post-content composition. Pair with SG-Admin Blogs Reference for the producing surface.
Related reading
- Components — parent Reference.
- Basic Blocks — foundational blocks Posts blocks compose with.
- Ecommerce Blocks — sibling category.
- Extra Blocks — sibling category.
Vocabulary cross-reference
- Post is a record administered in the admin Blogs.
- Posts block is a SG-Builder component that surfaces post records.
- Posts Archive is the listing block — surfaces multiple posts on index and category pages.
- Post detail template is the page template composed from individual primitive blocks (Post Title, Content, Featured Image, Navigation, Related Items) for a single post's page.
- Featured Image is the image field on the current post record (not a "featured post" concept — that is a filtering mechanism in Posts Archive).
Maintenance discipline
When Posts Blocks change across releases (new block type, new filter dimension, new pairing with SG-Admin Blogs), update this Reference and log the change in Changelog.
Related reading
| Topic |
|---|
| Components |
| Basic Blocks |
| Ecommerce Blocks |
| Extra Blocks |