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.
- Add (BU)Star Ratings to a page or a repeated content card.
- Enter Rating points as a numeric value within the intended five-point scale.
- For dynamic scores, supply a compatible current-record dynamic value and test several records.
- Choose With empty stars or Without empty stars under Display stars.
- Set Fill stars color, Empty stars Color, Stars Size, and Space between stars.
- Enter an accurate Aria label and include a visible numeric score nearby when useful.
Controls and Settings
| Control | Purpose and usage |
|---|---|
| Rating points | The score used for the visual fill, such as 3.7. Validate source values between 0 and 5 before publishing. |
| Display stars | With empty stars shows the full scale; Without empty stars changes the empty-star presentation. |
| Aria label | Describe the real score, for example Rated 3.7 out of 5. Keep it synchronized with the displayed value. |
| Colors | Use distinguishable filled and empty states with adequate contrast. |
| Size / Spacing | Set 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.