# Blog posts

**Blog posts** on a website diversify content, enhance SEO, engage audiences, build authority, educate customers, encourage social sharing, and support lead generation, contributing to an enriched website experience.

<figure><img src="/files/lTDqFkFRSh1duG2fEeKj" alt=""><figcaption></figcaption></figure>

## Section settings

### General setting

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Section width</strong></td><td><p></p><p>3 options for container</p><ul><li><em><strong>Stretch width</strong></em>: span the section width regardless of screen size.</li><li><em><strong>Fix width</strong></em>: depends on your page content width in <strong>Theme settings</strong> <strong>-></strong> <strong>Layout</strong>.</li><li><em><strong>Expand full width</strong></em>: takes up the entire space on the page and it usually resizes itself to fit the size of the screen.</li></ul></td></tr><tr><td><strong>Color scheme</strong></td><td>Select colors from <strong>Theme settings -> Colors</strong></td></tr><tr><td><strong>Heading</strong></td><td>The title of the section</td></tr><tr><td><strong>Description</strong></td><td>The description of the section</td></tr><tr><td><strong>Alignment</strong></td><td><p>The position of the heading and description.</p><ul><li>Left</li><li>Center</li><li>Right</li></ul></td></tr><tr><td><strong>Show view all button</strong></td><td>When enabled, it will display a button with a link to the blog category page (Note: *Shown only if the blog includes more blog posts than currently shown)</td></tr></tbody></table>

### Blog posts

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Blog category</strong></td><td>Which blog you want to display blog posts from. Defaults to the first blog alphabetically on your <a href="https://shopfify.com/admin/blogs">Blogs page.</a></td></tr><tr><td><strong>Image ratio</strong></td><td><p>The image ratio for the featured images of the blog posts:</p><ul><li><strong>Adapt to image</strong> - Uses the aspect ratio of the images. This prevents the images from being cropped.</li><li><strong>Portrait</strong> - Crops the images to use a 3:4 ratio.</li><li><strong>Square</strong> - Crops the images to use a 1:1 ratio</li><li><strong>Landscape</strong> - Crops the images to use a 4:3 ratio</li></ul></td></tr><tr><td><strong>Maximum items to show</strong></td><td>Limit the display of the number of posts. Minimum: 2. Maximum: 6</td></tr><tr><td><strong>Items per row on desktop</strong></td><td>Number of columns to display on desktop computers. Minimum: 2. Maximum: 4.</td></tr><tr><td><strong>Column gap</strong></td><td><p>4 options for column gap</p><ul><li>Small</li><li>No gap</li><li>Medium</li><li>Large</li></ul></td></tr><tr><td><strong>Show category</strong></td><td>Display blog categories</td></tr><tr><td><strong>Show date</strong></td><td>Display post creation date</td></tr><tr><td><strong>Show author</strong></td><td>Display post author</td></tr><tr><td><strong>Show excerpts</strong></td><td>Display a short post excerpt</td></tr></tbody></table>

### Settings for carousel

<table data-full-width="false"><thead><tr><th width="143">Setting</th><th>Description</th></tr></thead><tbody><tr><td><strong>Enable carousel</strong></td><td>When enabled, the section will be displayed in carousel format</td></tr><tr><td><strong>Show navigation</strong></td><td>Display the next and back controls for the carousel</td></tr><tr><td><strong>Show pagination</strong></td><td>Display the pagination for the carousel</td></tr></tbody></table>

### Section padding

* **Top padding:** Customize the top margin of the section
* **Bottom padding:** Customize the bottom margin of the section


---

# Agent Instructions: 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:

```
GET https://nextsky.gitbook.io/agile-theme/sections/blog-posts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.