> ## 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.

# Article

> A blog post: tag, reading time, title, excerpt and byline, the featured image, a table of contents, the author card, share links, comments and related articles.

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

Article, highlighted with the demo content

## Where to find it

The article template (article.json), used by every blog post, such as the demo's /blogs/journal/build-1440p. In the theme editor choose **Blog posts** in the page selector, then **Default blog post**, and select **Article**.

## How it works

* The header shows the first tag as a link to that tag's page, the reading time, the title, the excerpt, the author, the date and, when comments are on, a comment count that jumps to them.
* The featured image shows as a wide strip, cropped to about 2.2 to 1.
* The table of contents (On this page) is built from the article's Heading 2 and Heading 3 when it has two or more. Heading 2 entries are numbered, and the heading being read is marked as shoppers scroll. It sits open beside the article from 1000 px and folds above it on smaller screens.
* The author card (Written by) beside the article uses the photo and bio from the author's staff account, or the first letter of the name. It is hidden under 1000 px; the byline stays.
* In the article text, Heading 1 to Heading 6 and lists follow the theme's text styles, a quote becomes a callout box (bold words at its start become its label), images with captions are styled as figures, and tables scroll sideways inside a labeled frame.
* Share links: Copy link, Share (where the shopper's device offers it), Email, X, Facebook and LinkedIn. They are plain links; no social scripts load.
* Comments show when the blog allows them: 50 per page, then Shopify's comment form with name, email (never published) and comment (up to 1,500 characters). On a moderated blog the form says comments appear once approved.
* Related articles shows three articles from the same blog, those sharing the first tag first, with an All articles link.
* Apps can add blocks under the article text: click Add block and choose one from the Apps tab.
* A Custom Liquid block adds your own code under the article text, such as a snippet an app gives you to paste. App blocks and Custom Liquid blocks show in the order you drag them into.

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

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

## Edit it

* Turn on or off Show the featured image, Show the excerpt, Show the author, Show the table of contents, Show share links and Show comments.
* Structure long articles with Heading 2 and Heading 3 in the article editor so the table of contents is useful.
* Allow comments per blog in Online Store → Blog posts → Manage blogs; Show comments only shows them when the blog allows them.
* Edit Heading for related articles, or untick Show related articles.
* Add a photo and a bio to each author's staff account to fill in the author card.

## 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. |
| **Show the featured image** | On or off. Default: on. |
| **Show the excerpt** | On or off. Default: on. |
| **Show the author** | On or off. Default: on. |
| **Show the table of contents** | On or off. Built from the article's headings when it has two or more. Default: on. |
| **Show share links** | On or off. Default: on. |
| **Show comments** | On or off. When the blog allows comments, in Online Store, Blog posts, Manage blogs. Default: on. |

**Related articles**

| Setting | What it does |
| - | - |
| **Show related articles** | On or off. Three articles from the same blog, those with the same first tag first. Default: on. |
| **Heading** | Text. Default: Keep reading. |

## Blocks

Add a block with **Add block** under the section in the sidebar; drag blocks to reorder them.

### App blocks

Blocks from apps you have installed, such as reviews or subscriptions. Click **Add block** and choose one from the Apps tab; its settings come from the app.

### Custom Liquid

| Setting | What it does |
| - | - |
| **Liquid code** | Liquid code. Add app snippets or other code. Shown after the article, in the order of the blocks. |


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