> For the complete documentation index, see [llms.txt](https://modutheme.gitbook.io/helix/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://modutheme.gitbook.io/helix/other-sections/blog-posts.md).

# Blog posts

The main section on the blog listing page. It shows the blog title, an optional tag filter, and the paginated grid of post cards. Fixed to the blog template.

![Blog Posts section overview](/files/8veCRHmHILaAOnTbPCTM)

{% hint style="info" %}
**Tip:** Turn on the Tag Filter block for blogs that cover several categories, so visitors can jump straight to the posts they want.
{% endhint %}

***

## Settings

| Setting                 | Description                                                                                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Posts per page          | Number of posts shown before pagination appears.                                                                                                                                |
| Width                   | **Page** — Keeps the content within the page width set in your theme settings. **Full** — Stretches the content across the full browser width, with a small space at the edges. |
| Alignment               | Aligns the blog title and tag filter.                                                                                                                                           |
| Gap — Desktop           | Vertical spacing between blocks on desktop.                                                                                                                                     |
| Gap — Mobile            | Vertical spacing between blocks on mobile.                                                                                                                                      |
| Color scheme            | Background and text colors for the section.                                                                                                                                     |
| Padding top / bottom    | Outer vertical spacing.                                                                                                                                                         |
| Custom padding — Mobile | Override desktop padding with independent mobile values.                                                                                                                        |

***

## Available Blocks

The section uses three static blocks. Their order is fixed and cannot be rearranged.

### Blog Title

The current blog's name, shown as the page heading.

| Setting       | Description                                                                            |
| ------------- | -------------------------------------------------------------------------------------- |
| Show RSS icon | Adds an RSS feed link beside the title.                                                |
| Size          | Heading 1–6.                                                                           |
| HTML tag      | Semantic tag rendered (Paragraph, H1–H6). Use headings in order for SEO.               |
| Padding       | Outer spacing: top / bottom, with independent mobile values via **Custom for mobile**. |

### Tag Filter

A row of all tags used in the blog. Clicking a tag filters the posts below.

| Setting                | Description                                                                            |
| ---------------------- | -------------------------------------------------------------------------------------- |
| Tag limit              | How many tags to show before the rest are hidden.                                      |
| Style                  | **Underline** or **Button**.                                                           |
| Font                   | Typeface of the tag labels — Default, Heading, Body, or Accent.                        |
| Font size              | Size of the tag labels.                                                                |
| Letter spacing         | Letter spacing of the tag labels.                                                      |
| Gap — Desktop / Mobile | Space between tags.                                                                    |
| Padding                | Outer spacing: top / bottom, with independent mobile values via **Custom for mobile**. |

### Post List

The paginated grid of post cards.

| Setting               | Description                                                                |
| --------------------- | -------------------------------------------------------------------------- |
| Columns               | Number of cards per row — 2 to 5.                                          |
| Horizontal / Vertical | Spacing between cards and rows, with an independent mobile vertical value. |