Skip to main content
The @ethioreview/review-widget-next package fetches widget data on the server and helps you emit schema.org JSON-LD. Pair it with @ethioreview/review-widget-react for client UI.

Who this is for

Next.js apps (App Router or Pages Router) that want SSR review data and SEO-friendly aggregate ratings.

Dashboard steps

  1. Integrations → API keys — create a key for the environment you will deploy (pk_test_* for preview, pk_live_* for production)
  2. Add your Next.js origins (localhost + deploy domains) to allowed origins
  3. Integrations → Review widgets — create a matching-environment widget and copy widgetId
  4. Optional: copy snippets from Integrations → Sandbox test

Install

Copy-paste — App Router

Server helpers

Environment variables

Use pk_live_* and a production widget ID in production builds.

One failure mode

Server fetch works but client widget is blank — SSR uses your server IP (no Origin check), while the browser still needs your Next.js origin on the API client’s allowlist. Add http://localhost:3000 and your deploy domain under Integrations → API keys.

Next

React embed → · iframe embed →