Grid / Listing Element

The Grid/Listing element is the universal tool for showing lists of posts or taxonomies via a grid of items.

Example

General #

Show: Post Type #

The General > Show settings allow choosing the post type to show in a grid. It supports regular posts and pages, products, media, and custom post types.

The "Show items of selected <taxonomy name>" setting allows specifying posts of which taxonomies should appear in the Grid/Listing element list. By default, it will show items of all taxonomies.

Show: Media (Images) #

The General > Show settings allow specifying the Media files to show in the Grid/Listing element list. 

If no images are specified, it will show all images from the Media admin page.

Example

You can specify which media category to show if media categories are active at Theme Options > Advanced. By default, it will show images of all media categories.

Show: Custom Appearance in Grid Images #

The Show > Custom Appearance in Grid > Images option allows listing the images from the relevant page settings.

Example

To show a Featured Image along with these images, activate the relevant "Include Featured image" setting.

When editing with Live Builder, you can find the "Custom Appearance in Grid" settings at "Page Settings" at the bottom of the side panel. When editing with WPBakery, you can find these settings at the bottom of the page.

Show: Items with the Same Taxonomy of Current Post #

This "Show" option allows showing posts similar to the current one based on the specified taxonomy.

Example usage:

  • Adding a list of similar products to the product page template (based on product categories).
  • Adding a list of similar posts for a blog (based on categories).

Show: Items of the Current Query #

This option allows showing items on archive pages.

According to WordPress logic, the archive pages list includes:

  • Taxonomy archive pages (categories, tags, product attributes, custom taxonomies, etc.).
  • A search results page.
  • A shop page.

When editing the template for an archive page, it's essential to include a Grid/Listing (or a Carousel) element set up to Show > Items of the current query to view relevant elements.

Show: Child Pages of Current Page #

This option shows the list of child posts/pages for the currently viewed one. It works for all post types that support a hierarchical structure.

Show: Manually Selected Items #

This option allows forming the custom list of posts/pages to view via Grid/Listing. It supports combining different post types into a single list.

Show: Terms of Selected Taxonomy #

This option allows viewing the list of taxonomy terms you specify via the dropdown.

Example

You can include child and empty terms in the list by activating relevant checkboxes. By default, the child and empty terms are not showing.

Show: Child Terms of the Current Term #

The option for archive pages. Allows listing the child terms of any term's currently viewed archive page.

You can include child and empty terms in the list by activating relevant checkboxes. By default, the child and empty terms are not showing.

Show: Selected Terms #

This option allows forming a custom list of terms to view it in a Grid/Listing. It supports combining terms of different taxonomies into a single list.

Show: WooCommerce Product Gallery #

This option is for the product page template or its content. It allows showing a list of images from the product gallery via the Grid/Listing.

You can include the featured image in this list by activating the relevant setting.

Show: WooCommerce Upsells #

This option allows using the Grid/Listing element to view a list of linked products specified as upsells.

Linked product: Upsells settings

Show: WooCommerce Cross-sells #

This option allows using the Grid/Listing element to view a list of linked products specified as cross-sells.

Linked product: Cross-sells settings

Order #

This option allows ordering items inside the Grid/Listing based on the specified parameter.

Example

The number of available ordering options depends on the "Show" settings and varies based on it.

Items Quantity #

Allows limiting the number of items shown in the Grid/Listing by default. If the total number of items exceeds the specified limit, you can use pagination settings to show the rest.

Archive pages using the Grid/Listing element set up to Show > Items of the current query. In this case, you can define the number of items shown by default at the admin page Settings > Reading > "Blog pages show at most".

Exclude Items #

This setting allows excluding items from the Grid/Listing element based on one of the pre-defined patterns:

  • Of previous Grids on this page -- excludes repeating items if shown previously on the page.
  • By the given quantity from the beginning of output -- it allows hiding the first N items of the Grid/Listing based on the specified number.
  • Out of stock -- option for the Grid/Listing showing WooCommerce products. It allows excluding items out of stock.

Action When No Results Found #

This option allows specifying the behavior pattern for cases when there's nothing to show inside the Grid/Listing element. For example, when there are no suitable search results or products matching the specified attribute filters.

Available actions are:

  • Show message -- it will show a custom text-based message declaring no results.
  • Show the Reusable Block -- it will show a custom-designed content block from Templates > Reusable Blocks if there are no suitable items. This Reusable Block might contain another Grid/Listing element, for example, to show popular or on-sale products if no products match the initial search result.
  • Hide this Grid -- it will simply hide the Grid/Listing element if there are no suitable items to show.

Pagination #

It allows choosing the pattern to show additional Grid/Listing items when the overall item number exceeds the Items Quantity value.

Available options are:

  • Numbered pagination -- shows the numbered list below the Grid/Listing element. Clicking on the number shows relevant items.
  • Load items on button click -- it adds a "Load More" button below the Grid/Listing element. Clicking on the button loads additional items. You can edit the button style and label using relevant controls. 
  • Load items on page scroll -- it will load additional items once the browser's viewport reaches the bottom of the list.

Appearance #

Grid Layout #

This option allows specifying the template for the Grid/Listing items. You can use a pre-designed template or a custom one from Templates > Grid Layouts.

Display As #

This option allows specifying the style for the Grid/Listing items.

  • Regular Grid.
  • Masonry.
  • Metro (works with square items only).

Regular grid example

Masonry example

Metro example

If Grid/Listing items have different sizes, you can adjust styling by activating relevant "Center items vertically" and "Ignore items custom size" settings.

Items Animation on Load #

This option allows specifying the Grid/Listing items animation on load. It applies to the Grid/Listing items that appear on page load and extra items loaded with button- or scroll-based pagination.

Columns #

This option specifies the baseline number of columns (number of items per row) the Grid/Listing element should use.

In the Responsive settings tab, you can adjust the number of columns per device/screen size.

Post Image Size #

This option defines the image size (thumbnail) used to view the image in a Grid/Listing item. By default, it uses the size specified in the Grid Layout settings.

Post Title Size #

Allows specifying the size for the titles (Post Title elements inside the Grid Layout) for the Grid/Listing items.

Items Aspect Ratio #

This option allows specifying the item's Aspect Ratio - the proportion of its width and height. It supports popular aspect ratios and allows setting the custom one if needed.

Overriding Link #

This option makes the Grid/Listing item area clickable and specifies the action it should perform on click. You can set a direct redirect link or choose one of the dynamic actions via the icon on the right.

Example

"Global Values" inside the dynamic actions got handy pre-designed patterns, for example:

  • Post Link - it opens a post in a new browser tab.
  • Open Post in popup - it opens a popup with all the post content.
  • Open Post image in popup - it opens only a post image in a popup, allowing to switch between images of viewed items.
  • Media File: Custom Link - the Grid/Listing element viewing Media (images) uses the images' "Custom link" value for the redirect. You can assign custom links while adding images to the list.

Example: image custom link

You can use the Advanced Custom Fields (ACF) plugin to assign custom fields with links to different post types. In this case, you can pick relevant links via the dynamic values for the overriding link.

Setting the Overriding Link makes the entire list item a single clickable area with a single link.

If you want to use different redirects inside the Grid/Listing item, for example, a title opening a post and the category opening the category archive, leave the Overriding Link value empty.

Filter #

This option allows adding a built-in filter for the Grid/Listing items. You can pick a taxonomy to filter by, filter styling, and alignment. 

If you need more complex filters with multiple taxonomies and more customization, use the separate Grid Filter element instead of the built-in filter.

Responsive #

This option allows adjusting the number of columns (items per row) in the Grid/Listing for different screen widths (devices).

Display Logic #

This setting allows specifying conditions to define if the element should appear. You can read the relevant article for more details on how to set it up.

Design #

Design settings allow adding some styling and customization to the element. It's similar for all theme elements; you can read more about it in the Elements article.