Related Products
Create a custom related-products section for a single product. WooCommerce supplies the related IDs; BricksUltimate lets you design the repeated cards instead of using the standard related-products markup.
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.
Assign meaningful categories and tags to the source and candidate products. Open a single-product template and select a real product for preview. Use several published, eligible products for testing.
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 Related Products (Single Product Page) 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 |
|---|---|
| Number of items to show | The requested count is passed to WooCommerce when collecting related IDs. The final visible count can be lower after filtering. |
| Order | An Order control is exposed, but the query uses the returned ID sequence rather than a selectable Date or Price ranking. |
| Other filters | Category, stock, visibility, and price controls from the generic Products provider are not exposed here. Shared query exclusions still apply. |
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.
How Related Products Are Chosen
The query calls wc_get_related_products() for the current product and excludes its assigned upsell IDs. WooCommerce related-product logic and filters decide the candidate relationships; results can vary with its cached or randomized selection. This provider does not offer a manual Include list or recommendation scoring controls.
Use Product Upsells for curated alternatives, or Product Cross-sells for curated accessories.
Practical Example
Add a You May Also Like section below the product details. Choose Related Products (Single Product Page), set the count to 4, and build a repeated product card. Test products from two different categories so the recommendations change with the source.
Scope and Limitations
Related products are not personalized browsing-history recommendations and do not guarantee a fixed editorial order. Use a compact collection and verify the live result, especially when another plugin filters WooCommerce related IDs.
Troubleshooting and Testing
Check preview context, shared categories/tags, catalog visibility, and pricing. Avoid testing on a standalone page with no source product. Current code only assigns the related ID constraint when it resolves a product, so missing context must not be treated as a reliable empty result.
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.