Blocks »Blog Posts Block

The Blog Post block allows you to insert a list or grid of up to 100 blog posts on any page. You can choose to show posts based on category, author, or tag, display featured images or excerpts, change the text color, and more!

Table of Contents

The Blog Posts block is replacing the Blog Listings block. If you still have the Blog Listings block on your site, you’ll see an option to upgrade to the Blog Posts block.

Add the Blog Posts Block

To add a Blog Posts block, use the Add Block button and either use the search or locate the block in Design section.

You can also type /blog and press enter:

Detailed instructions on adding blocks can be found here.

↑ Table of Contents ↑

Block Toolbar

Clicking on the Blog Post block will bring up a toolbar that has a few different options to change the look of the block:

Block Width

Selecting the block width option will let you choose whether to show the block as Wide Width (wide but with padding on both sides) or Full Width (spanning the screen from edge to edge with no padding).


The block has an option to display posts in a List View or a Grid View:

Example of a Grid view

When in Grid View, you can change the number of columns shown under Display Settings in the block settings on the right.

Media Location

You can set the media location so that the image appears on top, to the left, right, or behind the text of the post:

Image Shape

These options let you change the shape of the media displayed between landscape, portrait, square and un-cropped.

↑ Table of Contents ↑

Block Settings

When you add a Blog Post block, you can click on it to bring up the block settings on the right side of the screen.

If you do not see the sidebar, click the ‘cog’ icon next to the Publish button.


The Borders option lets you add a border between the posts in list view and columns in grid view. The Default option has no borders.

Display Settings

Use the Display Settings to control which posts that are displayed in the block.

Display Settings - Blog Posts Block

The Choose Specific Posts toggle will let you show only specific posts that you choose to add. To add a post, begin typing the post title and some suggestions will appear. Click on the post you want from those suggestions and it will be added to the block.

Number of Items lets you choose how many posts appear in the block. You can have a minimum of 1 post or a maximum of 100 appear in the block.

Displaying 100 posts at once may slow down your page loading time considerably. Generally, it is recommended to choose a low number of posts to display (less than 15 posts) and then include the Show “More” Button (see below) for your readers to load more posts if they wish.

You can enter specific Authors, Categories, or Tags into any of those text fields to display specific posts that fit your criteria. You can enter more than one in each field, separated by commas.

The Show “More” Button toggle will let you have a button at the bottom of the block that will let visitors load more posts. Note that this feature will not be available unless the site is public.

This option lets you toggle on displaying a featured image for the posts in the block. If the option is toggled on, you’ll see another option that lets you choose to display the featured image’s caption.

Post Control Settings

The Show Excerpt toggle will let you hide or show post excerpts inside the block.

The Type Scale slider lets you adjust the font size for the post title and excerpts inside the block.

Color Settings

Text Color will let you alter the text of the post titles and excerpts inside the block.

Post Meta Settings

This setting has toggles for showing or hiding the Date, Category, Author and Author Portrait inside the block.

↑ Table of Contents ↑

Frequently Asked Questions

Why does it say “Sorry, no posts were found”? You will see this message in the Blog Post block if you have no published blog posts. You can go to My Site → Site → Posts and make sure you have at least one published post.

Another reason for this message is that you might have more than one Blog Post block on the same page. A post will only show once on a page, regardless of how many Blog Post blocks you add. However, you can add multiple Blog Post blocks onto a page if you set them to show different posts. For example, one block could be set to show posts with the category “Lunch” and another block could be set to show posts with the category “Dinner”. These two blocks would show a different set of posts, but if you had one post categorized as both “Lunch” and “Dinner”, it would still only show once on the page.

↑ Table of Contents ↑


The Additional CSS Class box lets you assign one or more custom CSS classes to the block. If your site is on the Premium plan or higher, you can use custom CSS to make further customizations to the block. Learn more.

Not quite what you're looking for?

Get Help