Page cover
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

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.


Set up section

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

Click the section to edit general section styles, like colors, width, padding, and the section header.

Editing templates change all pages that use that template. For unique pages, use new templates or dynamic metafields

Section style guides


Select blog posts source


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

For Selected block source, click Change to select a blog to display its latest posts.

Number of articles

Choose how many posts to display from your Selected blog source: between 2 and 12.

Add article

For Custom list, 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.

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.

Select 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)


Related links

Blog posts template Blog page template

Last updated