Skip to main content
1

Confirm plan includes API access

Widget and API client features require api_access on your subscription plan.
2

Create SANDBOX API client

  • Environment: SANDBOX
  • Allowed origins: your localhost and staging URLs
  • Save pk_test_* and sk_test_* (secret shown once)
3

Create SANDBOX widget

Link to the sandbox client. Set min stars (4+) and limit (5).
4

Embed on staging

Use the copied snippet or React component. Verify synthetic reviews load.
5

Create PRODUCTION API client

  • Environment: PRODUCTION
  • Allowed origins: production domain(s) only
6

Create PRODUCTION widget

Match environment to production client.
7

Deploy

Replace pk_test_* with pk_live_* in production build. Never deploy secrets to the browser.
8

Monitor

Check API client lastUsedAt in dashboard. Use widget telemetry events for analytics.

​
Common issues

ProblemFix
CORS / 403 OriginAdd exact origin to allowedOrigins (include https://, no trailing path)
Empty reviewsProduction org may have no ACTIVE 4+ star reviews yet
Widget misconfiguredEnsure data-public-key and data-business-id or data-widget-id are set
Widget credentials →