Skip to main content
EthioReview ships 12 rating display layouts — badges, breakdowns, summaries, and hero banners. Each layout is a drop-in component that accepts the same review aggregate data from the widget API. Use this catalog to pick the layout that fits your page. Configure the closest match in the dashboard (Integrations → Widgets), or compose layouts directly with @ethioreview/review-widget-react.

Browse live UI previews

Open the component gallery to see all 12 layouts rendered with sample rating data.

Shared data shape

Every layout accepts a ReviewAggregateData object:
Fetch this from GET /widgets/businesses/{orgId}/rating or GET /widgets/resolve/{widgetId} with your publishable key.

Quick reference

Hero review banner

Landing pages and homepage hero sections. Layout key: hero-banner

TrustScore summary

Above-the-fold headers and product detail pages. Layout key: trust-score

Rating breakdown card

Transparency sections with per-star bars. Layout key: rating-breakdown

Vertical stacked card

Sidebars and narrow columns. Layout key: vertical-stacked

Micro badge

Inline placement next to product names. Layout key: micro-badge

Inline rating pill

Footers, product cards, nav bars. Layout key: inline-pill

Review carousel card

Testimonial sections with featured quotes. Layout key: review-carousel

Comparison strip

KPI rows and analytics panels. Layout key: comparison-strip

Circular score

Dashboards and stat panels. Layout key: circular-score

Verified business card

Trust badges and checkout pages. Layout key: verified-business

Floating badge

Sticky corner placement. Layout key: floating-badge

Dark promo card

Marketing pages and dark sections. Layout key: dark-promo

Layout reference

Dashboard widget types

When you register a widget in the dashboard, choose the type closest to your target layout: Set min stars, limit, and theme colors in the widget config JSON. See Widget registry for API details.

React usage

Import the stylesheet once in your app entry:

Auto layout from dashboard widget

ReviewWidget picks a layout from your registered widget type, or you can override with the layout prop:

Pick a layout explicitly

Compose a layout with your own data

The SDK exports all 12 layout components, primitives (StarTiles, RatingBar, EthioReviewLogo), and legacy list helpers (TestimonialCard, RatingSummary, ReviewList). React embed guide → · Widget overview →