Loop Module

Use the Loop module to build fully custom post loops with complete design control over each item, using any Beaver Builder module as the template. Requires Beaver Themer.

Usage

The Loop module builds fully custom post loops where you have complete control over the layout and design of each loop item. Unlike the Posts module which provides a fixed set of layout options, the Loop module is a container that accepts any Beaver Builder modules as children. Design the template for a single loop item using modules like Heading, Photo, Rich Text, and Box, then the Loop repeats that template for each item in the query. Field connections pull in dynamic data such as the post title, featured image, excerpt, and custom fields for each iteration.

note

The Loop module requires Beaver Themer. When adding the module, four pre-configured variations are available: Blank, List, Columns, and Categories. Each variation comes with a starter template of child modules and field connections that you can customize after inserting. A Product Categories variation is also available when WooCommerce is active.

The Loop module is most useful in Beaver Themer archive and singular layouts, where the query is tied to the page context. Common applications include blog post grids, category directories, team member listings, product archives, and related posts sections on single post templates.

Module Settings

The Loop module provides settings organized across three tabs for controlling grid layout, content queries, and pagination.

General tab

The General tab controls how loop items are arranged in the grid.

Item Sizing Default: Columns

Determines how the grid column widths are calculated.

• Columns: Sets a fixed number of columns per row. The grid distributes items evenly across the specified column count.
• Item Size: Sets minimum and maximum width values per item. The grid auto-fills as many items as can fit per row based on the size constraints.

Columns settings

Number of Columns Default: 3 (large), 2 (medium), 1 (small); Supports: Responsive

Sets how many items appear per row when Item Sizing is set to Columns.

Item Size settings

Minimum Width Default: 100px; Supports: Responsive

Sets the minimum width each loop item can be when Item Sizing is set to Item Size. Accepts px and fr units.

Maximum Width Default: 300px; Supports: Responsive

Sets the maximum width each loop item can be when Item Sizing is set to Item Size. Accepts px and fr units.

Gap Default: 20px; Supports: Responsive

Controls the row and column spacing between loop items. Row and column gaps can be set independently. Accepts px, em, %, vw, and vh units.

Query tab

The Query tab controls the data source that powers the loop.

Source Default: Custom Query

Selects where the loop gets its data.

• Custom Query: Build a custom WordPress query by specifying post type, filters, and sort order.
• Main Query: Use the current page's main WordPress query. Ideal for archive templates in Beaver Themer where the query is determined by the page context, such as a category archive, author archive, or search results.
• Taxonomy Query: Query taxonomy terms such as categories, tags, or custom taxonomies instead of posts. Use this to build category grids, tag listings, or custom taxonomy directories.

Custom Query settings

Post Type

Selects which WordPress post type or types to query. Supports Posts, Pages, and any registered custom post types. Multiple post types can be selected.

Ordering settings

Ordering settings control how queried posts or items are sorted, such as by date, title, menu order, or custom ordering options where available.

Offset Default: 0

Skips a specified number of posts from the beginning of the query results. Useful for excluding the most recent posts when they are featured elsewhere on the page.

Exclude Current Post Default: No

When enabled, the post currently being viewed is excluded from the query results. Useful for related posts loops on single post templates.

Filtering settings

Filtering settings control which posts, terms, authors, or content types are included or excluded from the module output.

Authors

Filters the query to posts by specific authors entered by username. This field appears in the Filter section.

Custom field filter settings

Custom field filters limit queried content by matching custom field keys, values, and comparison rules where available.

Taxonomy Query settings

Taxonomy Default: Category

Selects which taxonomy to query. Options include all registered taxonomies such as Categories, Tags, and any custom taxonomies.

Select Terms to Display Default: All Terms

Filters which terms are included in the results.

• All Terms: Display all terms in the taxonomy.
• Top Level Terms: Display only parent terms with no parent of their own.
• Child Terms: Display only child terms of a specified parent term.

Child Terms settings

Parent Term

Selects which parent term's children to display when Select Terms to Display is set to Child Terms.

Order Default: Ascending

Controls the sort direction of the taxonomy terms.

• Ascending: A to Z or lowest to highest.
• Descending: Z to A or highest to lowest.

Order By Default: Name

Determines which field is used to sort the terms.

• Name: Sort alphabetically by term name.
• Term Count: Sort by the number of posts assigned to each term.
• ID: Sort by term ID.
• Meta Value (Alphabetical): Sort by a term meta value alphabetically.
• Meta Value (Numeric): Sort by a term meta value numerically.
• Parent: Sort by parent term ID.

Meta Value settings

Meta Key

The term meta key used to sort results when Order By is set to Meta Value (Alphabetical) or Meta Value (Numeric).

Hide Empty Default: Yes

When enabled, terms that have no posts assigned to them are hidden from the results.

Pagination tab

The Pagination tab controls how visitors navigate through multiple pages of loop results and what happens when no results are found.

Pagination Default: Numbers

Controls how visitors navigate through pages of results.

• Numbers: Standard numbered pagination links.
• Scroll: Infinite scroll that loads more items as the visitor scrolls down.
• None: No pagination; only the initial set of items is displayed.

Numbers settings

Auto-scroll on Pagination Default: Yes

Automatically scrolls the page to the top of the loop module when the visitor clicks a pagination link.

Posts Per Page Default: 10

The number of items to display per page. When pagination is enabled, this controls how many items appear before the visitor must paginate.

No Results Message Default: Sorry, we couldn't find any posts. Please try a different search.

A custom message displayed when the query returns no results.

Show Search Default: Show

When no results are found, shows or hides a search form below the no results message.

Advanced tab

The Advanced tab includes all the standard settings for margins, visibility, animations, and advanced HTML configurations.

See the Advanced tab section for more information.