---
description: Theme section
---

# Blog posts

The **Blog posts** section displays a carousel of featured blog posts. Select which articles to feature and customize the content and style of the section.

![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-c604aeb9a98cd410e16dd1c5711e81926773aaf2%2Fblog-posts.jpeg?alt=media)

{% hint style="info" %}
**Tip |** Check out Shopify's guide on [How to start a blog and grow your audience](https://www.shopify.com/blog/how-to-start-a-blog).
{% endhint %}

## Add images and excerpts

For the **Blog posts** section to display properly, you will need to add **Featured images** to posts in your Shopify admin.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your **Shopify Admin**:

1.  Find your blog posts under **Online Store > Blog posts**.

    ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-19a30b7f95f4cac5f8b07d7e33c276eb6f271eaf%2Fblog-posts-admin.jpeg?alt=media)
2.  In the **Featured image** section, click **Add image** to upload an image file.

    > There are no required dimensions. We recommend using the same shape and size for all blog images with a minimum width of **`2500px`** for optimal quality across all devices.
3.  In the **Excerpt** section, add a summary of your post.

    > If left blank, Lorenza will automatically display the first few sentences of the post. For the best results, add excerpts that are around the same length for all blog posts.
4. Click **Save**.

</details>

## Set up section

Add this section to any template (except Checkout) and use the drag-and-drop handles to re-order its position. You can add this section multiple times with different content and settings.

{% hint style="warning" %}
Editing a template changes all pages that use that template. To edit specific pages, you can [create new templates](../../../general/editing-themes/using-templates#create-and-assign-multiple-templates) or [use metafields and dynamic sources](../../general/adapting-your-theme/dynamic-content-with-metafields).
{% endhint %}

<details>

<summary><mark style="color:blue;"><strong>STEPS</strong></mark></summary>

In your theme editor (**Customize**):

1.  Select a **Template** to edit from the dropdown menu in the top bar.

    > Learn how to use templates in our [Templates guide](../../general/editing-themes/using-templates).
2. Under **Template**, click **(+) Add section** and select **Blog posts**.
3. Change the order of your sections by using the drag and drop handles **`⋮⋮`**

</details>

## **Add featured articles**

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your **Shopify Admin**:

1.  Find your blog posts under **Online Store > Blog posts**.

    ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-19a30b7f95f4cac5f8b07d7e33c276eb6f271eaf%2Fblog-posts-admin.jpeg?alt=media)
2.  In the **Featured image** section, click **Add image** to upload an image file.

    > There are no required dimensions. We recommend using the same shape and size for all blog images with a minimum width of **`2500px`** for optimal quality across all devices.
3.  In the **Excerpt** section, add a summary of your post.

    > If left blank, Lorenza will automatically display the first few sentences of the post. For the best results, add excerpts that are around the same length for all blog posts.
4. Click **Save**.

</details>

## Section content and style

Change the section style, adjust the number of columns, and crop the shape of your blog images. You can also change the section heading and link text for the buttons.

<details>

<summary><mark style="color:blue;">STEPS</mark></summary>

In your theme editor (**Customize**):

1.  Click on the **Blog posts** section to open the section settings.

    ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-a63350b6f0beb78d5f6d2ec7d76f919866fb06e3%2Fblog-posts-section-settings.jpeg?alt=media)
2.  (_Optional_.) Use the **Section style** dropdown to use **Contrast** colors.

    > The **Contrast** style uses the contrast colors in your **Theme Settings**.
3. Choose whether to **Enable animation** to show visual effects when scrolling, hovering, or interacting with the section.
4.  Use the **Columns per row** slider to adjust the number of Blog posts per row, between _2_, _3_, or _4_.

    > On mobile, articles are displayed in a single column carousel.
5.  To make your images a uniform shape and size, select the **Image aspect ratio** to crop your images to **Square**, **Landscape**, or **Portrait**.

    > The default **Natural** setting will display the original orientation of each image.

    ![](https://1086282208-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fl6iv1HA2gJCuwR5V6stX%2Fuploads%2Fgit-blob-18e593ad0edf007db92b2db4471c455059562ccf%2Faspect-ratio.jpeg?alt=media)
6. Enter **Heading** text to display above the title of each article.
7.  Enter **Link text** for the button under each article that links to the full blog post.

    > The default link text is "Read more".
8.  Use the **Max width of text** slider to control the maximum width of the article titles and excerpts.

    > Use this setting to create a clean visual shape for your text and avoid unwanted line breaks.
9. Click **Save**.

</details>

## Settings reference

Click on the **Blog post** section to find the following settings.

| Setting            | Description                                                                                                          |
| ------------------ | -------------------------------------------------------------------------------------------------------------------- |
| Style              | Use the Default or Contrast section style. The Contrast style uses the contrast colors in your Theme Settings.       |
| Columns            | Choose how many articles to display in each row. Select between 1 and 3 columns.                                     |
| Image aspect ratio | Crop the shape of your images to Square, Landscape, or Portrait. Choose Natural to display the original image shape. |
| Heading            | Change the "Story" heading text displayed above each article title.                                                  |
| Link text          | Change the "Read more" link text, which is used to link to each full article.                                        |
| Max width of text  | Use the slider to adjust the maximum width of the heading and excerpt text.                                          |
| <p><br></p>        |                                                                                                                      |

***

> **Related links**
>
> [Blog posts template](../../pages/templates/blog-posts-template)\
> [Blog page template](../../pages/templates/blogs-page)
