Product Ratings
(BU)Product Ratings shows a WooCommerce product's average as five stars, with optional numeric rating text and a review count. Add it near a product title or price, to a repeated product card, or to a featured product section. It displays a summary; the review list and the form for submitting reviews are separate.
Enable Reviews and Add the Element
- In WooCommerce → Settings → Products, enable Enable product reviews and Enable star rating on reviews if shoppers should be able to leave ratings. Review the options for requiring a star rating and restricting reviews to verified owners.
- Check that reviews are enabled for the relevant product. Use a product with an approved, rated review for your first test. If ratings are optional, a written review can contribute to the review count without contributing a star rating.
- Go to Bricks → BricksUltimate → Woo Elements, enable Product Ratings, and save. Reopen the Bricks editor and search for (BU)Product Ratings.
- Place the element and configure the display below. Preview on the storefront with both a rated product and a product with no reviews.
Choose the Product Context
- Single-product template: Leave Product ID blank so the element uses the current product. In the Bricks editor, preview with a product that has reviews.
- Product grid or archive: Put the element inside the repeated product card and leave Product ID blank. Check at least two cards with distinct ratings to confirm each shows its own data.
- Featured product on a regular page: Enter the numeric WooCommerce Product ID, not the SKU. This sets the product used for the stars and minimum review check. Bricks dynamic text tags may still use the surrounding product context. If you show text as well, place the element inside the matching product context and verify the values agree.
Configure the Rating Summary
- Do not show: Set the minimum number of reviews required to display the whole element. Enter
1to hide it on products without reviews, or5to show it once the product has at least five reviews. Leave it blank or use0to allow the summary with no reviews. This checks the review count, not the average rating or the number of reviews that include stars. - Stars: The element displays five stars with partial filling for fractional averages. Use Star color and Empty stars color to distinguish those states. Adjust Size in px, Gap, and the stroke controls. Fill empty stars lets you use a filled background for the unrated portion. Use Disable stars for a text-only summary.
- Average Rating Points: Enable Display rating points and set Text, for example
{product_average_ratings} out of 5. This reports the WooCommerce average on a five-point scale. - Total reviews: Enable Display total reviews and set Text, for example
({product_total_reviews}). The count is for the current product.
The average text and review-count text have separate width, height, padding, background, typography, and border settings. Leave room for larger counts and translated labels. Keep the stars readable next to the numeric value, and avoid using color alone to communicate the rating.
Example Layouts
- Product card: Enable stars and the review count, use
({product_total_reviews})for a compact label, and set Do not show to1if you only want to show summaries on reviewed products. - Single-product page: Show the numeric score, stars, and review count. Add a separate Read reviews link to your reviews section. For example, give the review section the CSS ID
product-reviewsand link to#product-reviews. The BU summary does not create that link automatically. - Text-only layout: Enable Disable stars and turn on rating points, review count, or both. Check the mobile layout with a longer label and a large review count.
Build a Custom Layout with Dynamic Data
Use the following tags in Bricks text elements when you want to place the score and count independently. The product tags use the current product context, so put them inside the relevant template or repeated card.
{product_average_ratings}: The current product's average rating formatted to two decimal places.{product_total_reviews}: The current product's WooCommerce review count.{bu_average_ratings}: Store-wide average across approved product reviews with positive rating values.{bu_total_reviews}: Store-wide count of approved product reviews with rating metadata. Use this for store-level summaries, not as the review count beside one product.
To show a separate No reviews yet message, place it outside the summary and use the BricksUltimate Has reviews? condition set to false in the same product context.
Related Ratings and Review Elements
- (BU)Product Ratings: Use this for a WooCommerce product summary that can display the stars, average, and review count together.
- (BU)Star Ratings: Enable Star Ratings under BricksUltimate's General Elements for a standalone star display. Enter a numeric Rating points value, such as
4.2, or supply a Bricks dynamic value, such as{product_average_ratings}in a product context. Choose whether to show empty stars and set an accessible label. This element does not automatically add a WooCommerce review count. - Bricks Product reviews or Product tabs: Use these native WooCommerce elements when shoppers should read reviews or submit one. For Product tabs, make sure the Reviews tab is available in the template. Keep the review form accessible even when a new product has no rating summary yet.
Troubleshooting
- The element is missing: Confirm WooCommerce is active and Product Ratings is enabled under Woo Elements. Reopen the editor after saving.
- The summary is blank: Check the current product or explicit Product ID and the Do not show threshold. If stars are disabled, enable at least one text section and give it text to display.
- Different cards show the same numbers: Keep the element inside the repeated product card, clear any fixed Product ID, and verify Bricks resolves the product tags for each card.
- The numbers and stars disagree: Confirm the text uses the current product's tags and not the store-wide tags or an unrelated product context. A product's review count can also include written reviews without a star rating.
- A new review does not change the summary: Check that the review was approved for the correct product and includes a star rating. Then check for cached product or archive pages.