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


  1. Activate WooCommerce and BricksUltimate.
  2. Open Bricks → BricksUltimate → Misc, enable Ultimate Woo Query Builder, and save.
  3. 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


  1. Add an outer Section or Block for the heading and layout. Keep the section heading outside the repeated item.
  2. Add an inner Block for one product card and enable Use query loop on that Block.
  3. Choose Ultimate Woo Query Builder as the query Type, then choose Best Selling Products under Woo query type.
  4. Enable Disable query merge where offered so the current page's main query does not unexpectedly constrain this custom collection.
  5. Configure the controls below and place the record's dynamic elements inside the repeated Block.
  6. Save and test on the frontend. Builder sample content is not a substitute for the live query result.

Controls and Behavior


ControlHow to use it
Number of items to showChoose the size of the collection; the default is 3.
Category(IDs) / Category operatorRestrict the ranking to the selected category terms using IN, AND, or NOT IN. Use IDs, not names or slugs.
Stock and visibilityConfigure Hide out of stock products and Show hidden products. Hidden products are excluded unless you explicitly allow them.
Hide free productsSet No explicitly if zero-priced products should qualify; an unset setting currently excludes them.
RankingThe 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.

Related Documentation