Posts List Block
The Posts List Block allows you to insert a list of your most recent posts. Selecting this block will actually insert a pre-customised version of the Query Loop Block into your content which is why it shows “Query Loop” in the Settings Sidebar. Although you can add this block into your normal Page or Post content, it will be more useful once you can edit your Theme’s templates.
When the Posts List Block is first inserted, you need to select the layout pattern to use for displaying your content. The Carousel view () or Grid view () icons that appear on the Block toolbar, simply change how the various layout patterns appear in the Block, within the editor, when it’s first inserted and have no effect on how your content will be displayed within the browser for your theme. The Carousel view allows you to select the block layout pattern using the Previous pattern and Next pattern arrow icons. The Grid view will show all the patterns at once, in a grid layout.
When using the (default) Carousel view, you can select the way the Post content is displayed by clicking the Previous pattern () and Next pattern () arrow icons within the toolbar at the top of the block. You can also click the Start blank link within the Block Toolbar to select the layout pattern.
After selecting how you want your content to be displayed, click the Choose button at the top of the Block if you’re using the Carousel view, or simply select your desired layout pattern if using the Grid view. Performing either of these actions will confirm how you want your content to display and also give you access to further options on the Block Toolbar and in the Settings Sidebar.
Once you’ve confirmed the layout pattern to use for the Posts List Block, you can use the Display settings () icon on the Block Toolbar and all the options in the Settings Sidebar to adjust the WordPress Query that is executed to retrieve your posts. You can control the number of posts to display per page, and select the Post type (e.g. display Posts, Pages, or even Products if you’re using WooCommerce). You can also choose the order to display your posts (e.g. newest first, oldest first, alphabetical), and also add filters such as Categories, Tags, Author or Keywords.
It’s important to note that the Posts List Block (and likewise, the Query Loop Block) will insert multiple blocks within the main Query Loop Block. Before you’re able to adjust all the settings for your Query Loop, you’ll need to select the outermost Query Loop Block. Selecting this block will show all the query settings in the Block Toolbar and the Settings Sidebar. If you’re finding it difficult to select the Query Loop Block, try selecting the Block by using the Block Breadcrumbs that appear at the bottom of the page. The Breadcrumbs will appear whenever you have a Block selected, and will list all the parent blocks for the currently selected Block. You can also use the List View icon () in the toolbar at the very top of the editor, to help you select the exact block you want.