Blog & Editorial Suite User Guide
Category: Marketing & Editorial
Registered Admin Route: /admin/page-components
This guide covers all registered blog grid, post hero, article body, blog search, and tag filter components used on Marketing surface pages.
Every row in the palette carries a ? button that opens that component's own help: overview, mental model, when to use it versus the alternatives, a complete property reference, worked recipes, accessibility and translation notes, gotchas, troubleshooting and an FAQ. It ships with the build, so it can never drift from the component you are configuring.
This guide is the map — which block to reach for and how they combine. The ? is the manual for each one.
A page's page type decides which blocks it is offered. If a component named here is missing from your palette, the page type is why — not a missing permission. See Visual Builder mode.
1. Blog List Component (blog_list)
Renders a dynamic grid or list of published blog posts from your Marketing Suite.
UI Controls & Options
| Field Label | Control Type | Selectable Options / Inputs | Purpose & Live Effect | Data Source Origin |
|---|---|---|---|---|
| Blog Category Filter | Dropdown Selector | List of active blog categories | Filters article grid to posts in selected category. | Populates from Marketing ➔ Blog Categories. |
| Blog Tag Filter | Dropdown Selector | List of blog tags | Filters article grid to posts matching tag. | Populates from Marketing ➔ Blog Tags. |
| Posts Per Page | Number Input | 1 to 24 articles | Maximum articles rendered per page. | User input (Default: 6). |
| Desktop Column Count | Dropdown Selector | • 1 Column (List) • 2 Columns • 3 Columns | Sets desktop grid layout. | UI Option (Default: 3 Columns). |
| Show Author & Date | Toggle Switch | On / Off | Displays author avatar, author name, and publication date on cards. | Toggle (Default: On). |
| Show Article Excerpt | Toggle Switch | On / Off | Displays 2-line article summary preview text. | Toggle (Default: On). |
2. Blog Post Hero (blog_post_hero) & Body (blog_post_body)
Used on individual blog post pages (PULSE_POST_001 template):
- Blog Post Hero (
blog_post_hero): Displays featured cover image, article title, publication date, reading time estimate (e.g.5 min read), category badge, and author profile card. - Blog Post Body (
blog_post_body): Renders the main article body content with formatted copy, embedded images, inline blockquotes, code blocks, and social share buttons (Twitter, LinkedIn, Facebook).
3. Blog Search & Tag Filters
- Blog Search Bar (
blog_search): Search bar allowing readers to search articles by title or keyword. - Blog Tag Filter Rail (
blog_tag_filter): Horizontal tag cloud or sidebar list of popular blog tags.