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.

Check out Shopify's guide on How to start a blog and grow your audience.

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.

You can also add Excerpts to your blog posts to customize the text that appears in the blog posts section. Otherwise, Stiletto will display the first few lines of your post.

STEPS

In your Shopify Admin:

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

   
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. (Optional.) In the Excerpt section, add a short summary of your post to appear in the blog posts section.

   For the best results, write excerpts that are approximately the same length for all blog posts.

4. Click Save.

Set up section

---

In the editor side panel, click (+) Add section and select Blog posts. Click and hold the drag handles ⋮⋮ to re-order sections.

Editing a template changes all pages that use that template. To edit specific pages, you can create new templates or insert dynamic content with metafields

Select blog posts to show

---

Display the latest posts from a Selected blog or create a Custom list of blog posts.

STEPS: Show latest posts

In your theme editor (Customize):

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

2. Under Blog post source, make sure the Selected blog option is enabled.

3. Click Select blog to find the blog you want to feature.

   Blogs are a Shopify feature. See their Blogs help guide ↗ to learn more.

4. Use the Number of articles slider to set the maximum number of recent blog posts (between 2 and 12).

5. Click Save.

STEPS: Show selected posts

In your theme editor (Customize):

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

2. Under Blog post source, select Custom list.

3. In the section list panel, click (+) Add Article to add an article block.

   Click Remove block or the eye icon to delete or hide a block.

4. Click Select Article to choose an article from the list.

   After you have selected a blog post, you can follow the Edit article link if you need to add a blog image and excerpt.

5. (Optional.) Click and hold the drag handles ⋮⋮ to rearrange the posts:

   

   Click Remove block in the block settings to delete a block.

   Click the Eye icon to hide or unhide a block.

6. Click Save.

Click Blog posts section to find settings

Setting	Description
Blog posts source	Choose to display latest posts from a Selected blog or a Custom list of blog posts that you can add and re-order as blocks.
Select blog	Click Change to select a a blog to display its latest posts. This setting applies only when Selected blog is enabled as the blog posts source.
Number of articles	Choose how many posts to display from your Selected blog source: between 2 and 12.
Add article	Add article blocks to your Custom list of selected blog posts. In the side panel, click (+) Article beneath the Blog posts section.

Customize blog post cards

---

Change the visual style of the featured posts, including the image aspect ratio, blog post details, and button.

Show blog post details

---

Choose which blog post details to show.

To edit the post details, go to Online Store > Blog posts from the Shopify admin.

Click Blog posts section to find settings

Setting	Description
Show article categories	Display tags that you've added to posts in the Shopify admin.
Show author	Display the name of who created the blog post.
Show published date	Display the date when the post was published.
Show excerpt	When checked, the first few lines of the post will appear below. You can add a custom excerpt to blog posts in your Shopify admin.
Show featured image	Show the blog post image added in your Shopify admin.

Change image shape

---

Change the aspect ratio to crop post images to be a uniform shape.

The aspect ratio of an image is the proportion between its width and height (w:h). A square image has equal width and height (1:1), whereas most images are either wider (2:1) or taller (1:2).

Click Blog posts section to find settings

Setting	Description	Options
Image aspect ratio	Select an aspect ratio to crop images to be a uniform shape, or select Natural to display images in their original shape.	Natural Portrait (2:3) Square (1:1) Landscape (3:2)

Section header

---

The Section header appears above the section. Add a Heading, Subheading, and optional Button.

Click Blog posts section to find settings

Setting	Description
Heading	Add or remove the title of the section.
Subheading	Add multiple lines of rich text below the heading. Use formatting buttons to add text styles, links, or lists.
Button link	Select or paste a URL that links to your blog page.
Button label	Enter text to display as the button label. Leave this field blank to remove the button.

Section style

---

Change the general section style and padding.

Click Blog posts section to find settings

Setting	Description
Enable animation	Choose whether to display visual effects when scrolling, hovering, or interacting with the section. See the Animation guide to learn more.
Top divider	Show a solid border above the section. The Top divider uses the Lines and borders color selected in the theme color settings.
Padding	Add a margin of space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.

---

Related links

Blog posts template Blog page template