Skip to main content
Registered widgets store display settings (type, min stars, theme config) and link to an API client.

​
Dashboard

Integrations → Widgets
FieldDescription
NameInternal label
TypeTESTIMONIAL, CAROUSEL, GRID, LIST, BADGE
EnvironmentMust match linked API client
Min starsMinimum rating (default 4)
ConfigJSON: limit, language, showAvatar, theme colors

​
API

# Create
POST /api/v1/widgets/registry

# List
GET /api/v1/widgets/registry?organizationProfileId=org_abc

# Resolve (public, with publishable key)
GET /api/v1/widgets/resolve/{widgetId}
Header: X-Widget-Key: pk_live_...

​
Embed with widget ID

<review-widget
  data-base-url="https://api.ethioreview.com"
  data-public-key="pk_live_..."
  data-widget-id="widget_abc"
></review-widget>
The resolve endpoint returns widget config + reviews + rating in one response. Widget overview →