Gold Penguin Logo with Text

Everything to Know About Post Loop Builder Queries in Breakdance Builder

Post loop builder queries provide you the freedom to customize post listings in any way you want. Read this guide to learn how to use them in Breakdance.
Updated October 1, 2023
post loop builder in Breakdance
post loop builder in Breakdance
Difficulty: Medium. You should know a normal amount about this tool/topic
Time Required: ~10 minutes

Imagine a system in your site where you can automatically pull a list of posts and display them on your page template.

This is made possible through the use of a post loop builder in Breakdance. With this element, you have the creative freedom to customize post listings in any manner you like. This is arguably one of the most important aspects of a WordPress website.

In this guide, I’ll show you how to add post loop builder queries to improve your web development experience. So keep reading!

post loop builder in Breakdance

What is a Post Loop Builder?

A post loop builder works like a loop - it keeps showing a series of posts that are included in your global block until there are none left to display. 

But before you can use this element, there are a few things you need to configure. First, you’ll need to create a global block template.   

A global block allows you to use repeated content blocks on specific pages. It’s like a blueprint used to display dynamic content. 

Once you have the global block, you’ll need to add it to your post loop builder. In the settings tab, you can format how each published post data is displayed. You can add conditions, meta queries, and order. There are also options to add a filter or pagination.  

With all these features, you gain more control in designing the layout and appearance of your post listings.

Creating a Global Block in Breakdance

1) Add a Global Block 

Assuming you've already created posts on your Breakdance site, it's time to set up a Global Block. 

Go to your WordPress dashboard and select Breakdance > Global Blocks.

add global block in Breakdance

Click 'Add Global Block' located at the top left. A pop-up will appear prompting you to name your Global Block. 

Breakdance global block template

Save and edit your template in Breakdance.

2) Edit Global Block in Breakdance Editor

In the Breakdance editor, add a section. From here, add other elements like images, headers, and texts. How you structure them is up to you, be it within a column, div, or grid. 

For this guide, I’ve wrapped the image, header, and text within a div element.

edit global block template

3) Add Dynamic Data to Global Block

Time to make our elements dynamic. 

To display the featured image, click on the image. Navigate to the content tab on the left and select the dynamic icon next to the image label. 

On the pop-up window, choose 'featured image' from the post section. 

add dynamic data in Breakdance

Repeat for the post title, date, and excerpt.

4) Style Your Global Block

For this tutorial, let’s make our global block simple. 

First, select an element you wish to style, then move to the styling tab on the left. Here, you can see options to modify the element’s size, layout, and color. For the texts, you can change the font size, font style, and alignment.

style global block in Breakdance

5) Save and Preview

Here’s the final look at our ‘blog’ global block template.

global block template in Breakdance

Adding a Post Loop Builder in Breakdance

1) Create a Page Template

In your WordPress dashboard, go to Breakdance > Templates. Click on Add Template > Add Custom Template.

On the pop-up window, fill in the details like the page template title, location, and priority number (conditions are optional). 

add page template in Breakdance

After entering the details, click ‘add template.’ Open your Breakdance editor and begin by adding a section. Then, add the Post Loop Builder element. 

add post loop builder element

2) Edit the Post Loop Builder Query

Click the Post Loop Builder element. On the left, tap the Query drop-down and select ‘Custom.’

add post loop builder query

Click the ‘Edit Query’ button. This will open up a pop-up window, as shown below.

post loop builder query

Here, you can modify the ‘Source’ and what type of posts you want to display. 

This feature is very useful if you’re creating custom post templates. If you haven’t tried it, read our separate tutorial about Working with Custom Post Types. It should explain all the basics you need to know about creating custom post types.

Since we are creating a page template to display blog posts, we’ll set the ‘Source’ to ‘Post Types’ and ‘Include’ to ‘Posts.’

Next, you can set how many posts you want to display per page. Adding conditions and meta query are optional, but very useful if you want to implement complex queries. For this tutorial, let’s keep it simple and leave these settings untouched.

Scroll down further to see the Order option. Here, you can choose a descending order to display the most recent posts or an ascending order to show older posts. For this tutorial, let’s choose ‘descending.’

When everything is set, click ‘Apply Query.’ 

3) Enable Pagination or Filter Bar

Now you have the posts displayed on your page. The next thing you might want to do is add a pagination to limit the amount of posts displayed on a single page, or use a filter bar to organize posts by categories or tags.

Unfortunately, in Breakdance, you cannot use both features in a post loop builder. 

But we’re hoping that Breakdance will upgrade this feature in the near future. For now, keep in mind that you can only choose between a pagination or a filter bar feature.   

Let’s try to enable each one by one and see how they work.

a) First, let’s enable pagination. On the pagination dropdown, choose how you want to organize your content. The most common way is to add numbers, so let’s do that. 

add pagination in Breakdance

Since we’ve set the post loop builder query to display three posts per row, you can expect to see at most three posts as you click each page number.

enable pagination in Breakdance

b) Next, let’s try the Filter Bar feature. When this is enabled, the pagination is automatically disabled.

enable filter bar in Breakdance

Choose how you want to organize your posts under the ‘Type’ dropdown. Here, we’re going to choose the ‘Categories.’

choose filter categories

In the editor, you should see two category tabs displayed at the top. The post loop builder query displays three posts per row but will appear in different category tabs.

Activating the ‘All Filter’ consolidates all three posts into one tab, as shown.

add filter categories

Here’s what our final page looks like with the Filter Bar.

add filter categories

That’s a Wrap!

Breakdance currently restricts users from adding both pagination and filter bar within the post loop builder query. But this website builder is still quite young.

With further updates, we remain optimistic about the addition of this feature in future releases. I’m pretty sure this will enhance the flexibility and functionality of the post loop builder element.

Want To Learn Even More?
If you enjoyed this article, subscribe to our free monthly newsletter
where we share tips & tricks on how to use tech & AI to grow and optimize your business, career, and life.
Written by Christy Cañete
Christy Cañete is a software engineer who's passionate about front-end web design. Not only can she code, but she writes too! She loves breaking down technical topics into super easy tutorials. If you're looking to learn without the jargon, she's your go-to.
Notify of

1 Comment
Most Voted
Newest Oldest
Inline Feedbacks
View all comments
Join Our Newsletter!
If you enjoyed this article, subscribe to our newsletter where we share tips & tricks on how to make use of some incredible AI tools that you can use to grow and optimize a business