Products
Build a custom shop grid, curated collection, or variation listing using WooCommerce products as loop items. Unlike a fixed product widget, the provider supplies the records while you design the repeated card in Bricks.
Enable and Prepare
- Activate WooCommerce and BricksUltimate.
- Open Bricks → BricksUltimate → Misc, enable Ultimate Woo Query Builder, and save.
- Reopen the Bricks editor so the query options refresh.
Publish the products you want to display and check their price, stock, catalog visibility, and category assignments. Use published products for public storefront layouts.
Create the Query Loop
- Add an outer Section or Block for the heading and layout. Keep the section heading outside the repeated item.
- Add an inner Block for one product card and enable Use query loop on that Block.
- Choose Ultimate Woo Query Builder as the query Type, then choose Products under Woo query type.
- Enable Disable query merge where offered so the current page's main query does not unexpectedly constrain this custom collection.
- Configure the controls below and place the record's dynamic elements inside the repeated Block.
- Save and test on the frontend. Builder sample content is not a substitute for the live query result.
Controls and Behavior
| Control | How to use it |
|---|---|
| Product types | All types(exclude variation) lists parent products. Choose a specific type for a simple, variable, grouped, or external collection. Variation product targets individual variations. |
| Status | Choose publish for shoppers. Draft, pending, and private are editorial states, not a substitute for access control. |
| Number of items to show | The default is 3. Set a modest page size; the editor control allows 1 to 30. |
| Include / Exclude | Search for specific parent products to include or omit. These selectors search products, not a dedicated variation selector. |
| Category(IDs) / Category operator | Enter comma-separated category term IDs. IN matches any listed category, AND requires all, and NOT IN excludes them. AND does not include child terms. |
| Parent | Use a variable parent product ID when querying its variations. Dynamic data is supported; a comma-separated list can target several parents. |
| Visibility and price | Set Hide out of stock products, Show hidden products, and Hide free products explicitly. In this implementation, an unset Hide free products value excludes zero-priced products despite the control placeholder saying No. |
| Order by / Order | Choose Date, Price, Random, Sales, ID, Title, or Name and ASC or DESC. Sales uses lifetime total_sales, not revenue or a date range. |
| Meta Query | Add a meta key, value, comparison, and type. Multiple rows are combined with AND. Use NUMERIC or DECIMAL for numeric comparisons; dynamic values and comma-separated arrays are supported. |
Design the Product Card
Inside the repeated Block, add a Product Image, a heading using the current product title, a product permalink, a WooCommerce price element, and a suitable add-to-cart control. Choose dynamic sources from the current loop item, not a hard-coded product. Keep the whole layout in the same product loop so image, title, price, and purchase action refer to the same product.
Set the outer wrapper to grid or flex, define responsive columns, and style one card. For a slider, use Slider (Nestable) and repeat its slide Block instead of repeating the whole slider. Configure slider arrows and breakpoints separately. Avoid nesting interactive buttons inside a fully linked card.
List Individual Variations
- Select Variation product without All types.
- Set Parent to the variable product ID, or use the parent product's dynamic ID in a single-product template.
- Set Show hidden products to Yes. The normal hidden-product filter forces parent ID 0, which conflicts with child variations.
- Leave category filtering empty initially: variations do not normally carry the parent's category terms directly.
- Use variation-aware image, price, and purchase elements and test that each purchase adds the correct variation.
Practical Example
Create a six-item Accessories grid: choose Products, enter the Accessories term ID in Category(IDs), set Number of items to show to 6, Order by to Date, and Order to DESC. Add one repeated card containing product image, linked title, price, and an add-to-cart control.
Scope and Limitations
This provider supports a paged products query. Put Bricks Pagination outside the repeated card and connect it to the correct loop where the control is available. Test page 2 on the frontend. Custom product grids do not automatically reproduce every native shop archive filter or third-party facet integration.
Troubleshooting and Testing
If variations disappear, check Show hidden products and Parent first. If a manually included product is missing, Include does not bypass the other stock, category, price, status, or visibility filters. Start without extra filters and add them back one at a time.
Test the populated and empty states, desktop and mobile layouts, and any relevant AJAX refresh. Keep headings and decorative wrappers from leaving empty gaps when no eligible results exist. If a query type is missing, verify the feature toggle, WooCommerce activation, and editor reload before changing the layout.