> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blog

> The blog page: an intro, the newest article featured, tag filters, article cards and pagination.

![Blog on the storefront](https://mintcdn.com/kwebby/tbWCv70mkhaUy_7w/images/kelvin/main-blog.webp?fit=max\&auto=format\&n=tbWCv70mkhaUy_7w\&q=85\&s=acddb2f0397ebe2368513b9de2b990fb)

Blog, highlighted with the demo content

## Where to find it

The blog template (blog.json), used by every blog, such as the demo's /blogs/journal. In the theme editor choose **Blogs** in the page selector, then **Default blog**, and select **Blog**. A Newsletter section follows it on install.

## How it works

* The blog's title is the main heading, with Intro under it.
* With Feature the newest article on, the first page with no tag chosen shows the newest article large: photo, a Featured label, the first tag, reading time, excerpt, author, date and a Read the article button. The grid below starts with the next article.
* Tag filters are links to each tag's page, so they work without JavaScript; the current tag is marked.
* Cards show the featured image cropped to 16 by 10, the first tag, the title, an excerpt of about 28 words, the date and the reading time. Three per row on desktop, two under 1000 px, one under 750 px.
* Reading time uses the article's custom.reading\_time metafield when it is set, else the word count at 220 words a minute (at least 1 min).
* Pagination is Page numbers, a Load more button, or Infinite scroll, which loads four more pages as shoppers scroll and then shows the button. Page links stay in the page for search engines.
* An empty blog or tag shows a message, with Show all articles on a tag page.
* Show the author applies to the featured article; cards do not show the author.

![Blog in the theme editor](https://mintcdn.com/kwebby/QKNMzt7KPy_yk6ai/images/kelvin/editor-main-blog.webp?fit=max\&auto=format\&n=QKNMzt7KPy_yk6ai\&q=85\&s=d814bffebc986d4e78ea6bda2bc03fd6)

In the theme editor: 1 the section in the sidebar · 2 its settings · 3 the section in the preview

## Edit it

* Edit Intro in one or two sentences.
* Choose Articles per page (3 to 24) and Pagination.
* Turn off Feature the newest article for a plain grid, and Show tag filters or Show excerpts if you do not need them.
* Tag articles in Online Store → Blog posts; the first tag shows on cards and decides related articles.
* Give every article a landscape featured image at least 1600 px wide.

## Settings

| Setting | What it does |
| - | - |
| **Color scheme** | Color scheme for this area (edit the schemes in Theme settings → Colors). Default: Scheme 1. |
| **Show breadcrumbs** | On or off. Default: on. |
| **Intro** | Formatted text. |
| **Feature the newest article** | On or off. On the first page, when no tag is chosen. Default: on. |
| **Show tag filters** | On or off. Default: on. |
| **Show excerpts** | On or off. Default: on. |
| **Show the author** | On or off. Default: on. |
| **Articles per page** | Slider from 3 to 24. Default: 10. |
| **Pagination** | Options: Page numbers, Load more button, Infinite scroll. Infinite scroll loads four pages, then shows the button. Page links stay for search engines. Default: Load more button. |

> [!NOTE]
>
> On install Intro is placeholder guidance that tells you what to write (Say what the blog covers, such as buying guides, setup walkthroughs and store news): replace it with your own.
>
> To set reading times yourself, add a definition in Settings → Custom data → Blog posts with namespace and key custom.reading\_time and type Integer, then fill in the minutes on each article.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.