Best Selling Products
Show a collection ranked by recorded sales volume. This is useful for a homepage bestseller section, category recommendations, or a compact popular-products slider.
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.
Use products with real recorded sales and valid prices. The provider sorts by WooCommerce product sales metadata, not an analytics report.
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 Best Selling 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 |
|---|---|
| Number of items to show | Choose the size of the collection; the default is 3. |
| Category(IDs) / Category operator | Restrict the ranking to the selected category terms using IN, AND, or NOT IN. Use IDs, not names or slugs. |
| Stock and visibility | Configure Hide out of stock products and Show hidden products. Hidden products are excluded unless you explicitly allow them. |
| Hide free products | Set No explicitly if zero-priced products should qualify; an unset setting currently excludes them. |
| Ranking | The provider fixes sales ranking to descending total_sales. There is no date-range, revenue, minimum-sales, or per-customer ranking control. |
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.
What Best Selling Means
The query uses total_sales as a numeric sort key. Products with no positive sales may still appear after higher-selling products; this is not a minimum-sales filter. A new catalog or tied sales values may therefore look like an ordinary collection.
Practical Example
Build a four-card Best Sellers band. Choose Best Selling Products, set the item count to 4, and keep category filtering empty for a store-wide collection. Add a category ID to make it a category-specific ranking.
Scope and Limitations
Use this as a limited collection, not an analytics dashboard or guaranteed paginated archive. It does not calculate revenue, conversions, or sales during a chosen month. The collection alone does not assign or render a Best Selling Badge.
Troubleshooting and Testing
If the order looks wrong, inspect the products' sales data rather than the card labels. Imported orders or custom order workflows may not populate sales totals as expected. Clear relevant caches after sales data changes.
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.