Blog posts

Theme section

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.

Tip | 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

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.

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

STEPS

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.

2. Under Template, click (+) Add section and select Blog posts.

3. Change the order of your sections by using the drag and drop handles ⋮⋮

Select blog posts to show

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

Show latest posts

STEPS

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.

Show selected posts

STEPS

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.

Section content

Add section headings and an optional button that can link to all your blog page.

STEPS

In your theme editor (Customize):

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

   
2. Enter Heading text to display a section title in the top-left.

3. Enter Subheading text to display below the heading.

   Use the formatting buttons to add text styles, links, or lists. To learn more, see Shopify's Rich text editor guide ↗.

4. Select or paste a URL for the Button Link.

5. Change the Button label (e.g. "View all posts").

   Leave this field blank to remove the button.

   The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now). To learn more, read "What is a Call to Action?"

6. Click Save.

Section style

Change the section style and padding, article options, number of posts, and the shape of your blog images.

STEPS

In your theme editor (Customize):

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

   
2. Under Article options, select the blog post content that you'd like to display for each featured post.

   Article options include: Article categories, author, published date, excerpt, and featured image.

   The content for these options is set up in the blog post editor ↗ in your Shopify admin.

3. To make your blog images a uniform shape and size, select a Featured image aspect ratio to crop your images to Square, Landscape, or Portrait.

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

   
4. Choose to display a Top divider that separates sections with a Solid line.

   The Top divider uses the Lines and borders color selected in the Theme Settings.

5. Set the Padding option to add space around the section to either the Top and bottom, Top only, Bottom only, or set it to None.

6. Click Save.

Settings reference

Click the Blog post section to find the following settings.

Section content

Setting	Description
Heading	Add text to show a main heading above the section. The default text is “Blog posts”.
Subheading	Add text to show a subheading below the main heading.
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. The most effective button labels ask customers to do something (e.g. Get started, Join us, Shop now).

Blog posts

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	Select a blog to display its latest posts, from newest to oldest. Click Change to select a different blog. 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. This setting applies only when Selected blog is enabled as the blog posts source.
Add article	Add article blocks to your Custom list of selected blog posts. In the side panel, click (+) Article beneath the Blog posts section. Click and hold the drag-and-drop handles ⋮⋮ to change the order of the blocks.
Show author	Show the author of the blog post.
Show published date	Show the date the blog post was published.
Show excerpt	Show the first few lines or summary of the blog post. You can add a custom excerpt in the blog post editor in your Shopify admin.
Show featured image	Show the blog post image added in your Shopify admin.
Featured image aspect ratio	Choose to crop all images to be a single uniform shape. Select Square (1:1), Portrait (2:3), or Landscape (3:2). Select Natural to display images in their original shape (without cropping). Learn more about aspect ratios in our Image settings guide.

Article options

Setting	Description
Show author	Show the author of the blog post.
Show published date	Show the date the blog post was published.
Show excerpt	Show the first few lines or summary of the blog post. Add a custom excerpt in the blog post editor in your Shopify admin.
Show featured image	Show the blog post image added in your Shopify admin.
Featured image aspect ratio	Choose to crop all images to be a single uniform shape. Select Square (1:1), Portrait (2:3), or Landscape (3:2). Select Natural to display images in their original shape (without cropping). Learn more about aspect ratios in our Image settings guide.

Section style

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