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

# Blog

**Blog** is the group of sections that bring your articles onto pages other than the blog itself. Instead of hoping shoppers find the blog through the menu, you place a row of recent posts on the homepage or a landing page, where they act as proof that the store is active and give search engines more of your writing to index. Shoppers see article cards with a featured image, a title, and optional details such as the date, author, and a short excerpt.

Use this group when your store publishes guides, styling advice, or brand stories that help people decide what to buy.

### Where to find it <a href="#where-to-find-it" id="where-to-find-it"></a>

{% hint style="success" %}
**Steps:**

1. Go to **Online Store > Themes > Customize**.
2. Open the template where the articles should appear, for example the homepage.
3. Click **Add section**.
4. Open the **Blog** group and choose the section you need.
5. Pick which blog the posts come from, then drag the section into position.
   {% endhint %}

*Result:* the most recent articles from the blog you chose are shown as cards, and the section updates on its own as you publish new posts.

### Sections in this group <a href="#sections-in-this-group" id="sections-in-this-group"></a>

| Section                                                       | What it does                                                                                                                                               | Use it when                                                  |
| ------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| [Blog posts](/velare/customize-your-pages/blog/blog-posts.md) | Shows the latest articles from one blog as a grid or a carousel, with control over which details each card carries and an optional button to the full blog | You want recent writing visible outside the blog page itself |

### Suggested reading order <a href="#suggested-reading-order" id="suggested-reading-order"></a>

1. Publish at least two or three articles first. The section has a minimum of two posts, and a nearly empty row makes a store look neglected.
2. Read [Blog posts](/velare/customize-your-pages/blog/blog-posts.md) and decide which card details you actually want. Date, author, tags, and excerpt can all be turned off, and fewer of them usually reads better on a homepage.
3. Set up the [Blog page](/velare/customize-your-pages/blog-page.md) as well, since the **View all** button in this section sends shoppers there.

### Related pages <a href="#related-pages" id="related-pages"></a>

* [Blog posts](/velare/customize-your-pages/blog/blog-posts.md): the only section in this group
* [Blog page](/velare/customize-your-pages/blog-page.md) and [Blog post page](/velare/customize-your-pages/blog-post-page.md): the templates shoppers land on after clicking a card
* [Storytelling](/velare/customize-your-pages/storytelling.md): other content led sections for the same part of the page
* [Colors](/velare/set-up-your-store/colors.md) and [Typography](/velare/set-up-your-store/typography.md): where the schemes and font presets come from


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://uxsmart.gitbook.io/velare/customize-your-pages/blog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.