The Query Loop block is used to display blog posts (or other content types such as pages, testimonials, or projects) on your website in different visual layouts. This guide will show you how to work with the Query Loop block in the WordPress editor.
In this guide
Have a question?
Ask our Support AssistantIn this video, you’ll learn how to use the Query Loop block on your WordPress.com site to display posts in different layouts. It covers changing the design, sorting posts, setting the number of posts per page, and filtering by category, tag, author, or search term.
The Query Loop block displays posts and other content on your site based on certain criteria, like category, tag, or publish date. The term “Query Loop” refers to the way WordPress “queries” (or searches for) specific content and “loops” through that content to show multiple posts.
The Query Loop block is a useful option for building engaging pages that automatically update as you add new posts. When you edit a block theme in WordPress, you’ll likely find this block used in common areas of a website like the blog page, news section, portfolio, and other places where new content is shared regularly.
You can also add a new Query Loop block via the + block inserter in the same way as you would add any other block. When you add the block for the first time, you can choose from a collection of predesigned layouts that you can later customize:
Learn more about how to customize the content and appearance of the Query Loop block in the following guides:
- Choose the content shown in the Query Loop block: How to control which posts and other content the block displays.
- Change the appearance of the Query Loop block: How to change the visual layout of the content the block displays.
