Blog & Content
Blog posts grid
Section handle:
blog-posts-grid
Settings
Layout
| Setting | Type | Default | Description |
|---|---|---|---|
| Posts per page | Slider | 6 | Posts per page before pagination. On the home page, this is how many of the latest posts show, followed by a link to the full blog. · Min: 3 · Max: 24 |
| Pagination mode | Dropdown | pagination | Load more adds the next page of posts below the current ones without leaving the page. Not used on the home page, which links to the blog instead. · Options: pagination – Numbered pagination, load_more – Load more |
Content
ℹ️ In theme editor preview, the "Add your first post →" button will replace the shopper button.
| Setting | Type | Default | Description |
|---|---|---|---|
| Blog | Blog | — | Leave blank to use the blog being viewed on a blog page. Anywhere else, choose a blog or the section shows its empty message. |
| Intro / description | Rich text | <p></p> | — |
| Show tag filter | Toggle (on/off) | On | Lists the blog's tags as links that filter the posts. Never shown on the home page, and hidden when no posts have tags. |
| Show featured image | Toggle (on/off) | On | — |
| Show excerpt | Toggle (on/off) | On | Shows each post's excerpt, or its first 32 words when it has no excerpt. |
| Show published date | Toggle (on/off) | On | Hiding the date also removes the month headings that group the posts. |
| Show author | Toggle (on/off) | On | — |
| Empty state heading | Text | No posts yet | Heading of the message shown when the blog has no posts. Leaving it blank hides the whole message, including its text and button. |
| Empty state text | Text | Posts will appear here once they’re published. | Shown under the empty-message heading when the blog has no posts. Blank uses the default text. |
| Button label | Text | Return to home page | Button in the message shown only when the blog has no posts. Blank hides the button. In the theme editor the button always links to your blog admin instead. |
| Button link | URL / Link | — | Where the empty-message button goes. Blank links to your home page. |
Default Configuration
When you add this section from the Theme Editor, it comes pre-configured with:
- Blog posts grid — default settings, no pre-added blocks