Product Upsells
Show the upsell products assigned to the current product. Upsells are alternatives or upgrades that you curate in WooCommerce, such as a higher-capacity model or a premium bundle.
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.
Edit the source product in WooCommerce. Under Product data → Linked Products → Upsells, select the recommended products and update the product. Open the single-product template with that source product as preview.
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 Product Upsells 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 | Limit how many assigned upsells appear; default: 3. |
| Hide out of stock products | Decide whether unavailable recommendations should be omitted. |
| Show hidden products / Hide free products | Set these explicitly for the intended catalog behavior. Set Hide free products to No if free recommendations are needed. |
| Order by / Order | Choose a supported product sort and direction. Do not assume the saved Linked Products selection order is preserved. |
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.
Product Context and Preview
The provider reads the upsell IDs from the current or preview product. It is intended for a product-context layout, not a generic page with no source product. In the builder, missing assignments can be replaced with recent products as preview placeholders; on the frontend, missing upsells return an empty list.
Practical Example
Add an Upgrade Your Choice band to a single-product template. Use Product Upsells with an item limit of 3. Test a source product with assignments and another without them; the second should not leave a misleading empty heading.
Scope and Limitations
This is a manually curated product recommendation loop. It does not add products to the cart automatically, create bundle prices, or infer upgrades from purchase history. Put the heading outside the repeated card and use an appropriate empty-state condition for the entire section.
Troubleshooting and Testing
If preview and live results differ, check the preview product and the saved Linked Products assignments first. Then check whether the recommended products are excluded by stock, price, or visibility.
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.