Star Ratings

Display a numeric score as a five-star visual, including fractional values. Use it for editorial scores, testimonials with a verified score, or custom-field ratings. It is a display element, not a review submission form.

Setup and First Use


Before starting, enable the relevant element or feature family under Bricks → BricksUltimate → General Elements, save, and reopen the Bricks editor. Integrations also require their corresponding plugin to be active.

  1. Add (BU)Star Ratings to a page or a repeated content card.
  2. Enter Rating points as a numeric value within the intended five-point scale.
  3. For dynamic scores, supply a compatible current-record dynamic value and test several records.
  4. Choose With empty stars or Without empty stars under Display stars.
  5. Set Fill stars color, Empty stars Color, Stars Size, and Space between stars.
  6. Enter an accurate Aria label and include a visible numeric score nearby when useful.

Controls and Settings


ControlPurpose and usage
Rating pointsThe score used for the visual fill, such as 3.7. Validate source values between 0 and 5 before publishing.
Display starsWith empty stars shows the full scale; Without empty stars changes the empty-star presentation.
Aria labelDescribe the real score, for example Rated 3.7 out of 5. Keep it synchronized with the displayed value.
ColorsUse distinguishable filled and empty states with adequate contrast.
Size / SpacingSet star size and inter-star space independently. Avoid making small card rows wider than their parent.

Static Scores Versus Product Reviews


The element renders the supplied score. It does not calculate a review average, collect ratings, verify purchases, or create review schema. For live WooCommerce ratings and review counts, use the separate Product Ratings elements and confirm product context.

Dynamic Data and Honesty


If a field is blank, nonnumeric, or uses a ten-point scale, normalize it before using it as Rating points. The built-in fallback can make an unconfigured element appear to have a real score. Do not show a decorative default rating as customer evidence. Avoid hard-coded aria text when a score varies by loop item.

Practical Example


Display an editorial score of 4.5 with the full five-star scale and a visible 4.5 / 5 text label. For a content loop, replace the fixed score only after confirming each record's data.

Troubleshooting


  • Wrong fill: inspect the raw numeric value and scale.
  • Same stars on every card: use current-loop dynamic data instead of a fixed score.
  • Overflow: reduce star size/spacing and check the card layout.
  • Wrong spoken score: correct the Aria label rather than only the visual color.

Related Documentation