SmartProof icon

SmartProof

Manage clients, locations, reviews, tags, and widgets in SmartProof

Widget → Create

AI-generated

Summary

Create a SmartProof widget for a client, optionally scoped to one location. Choose its visual style and review tag filter, then configure widget behavior through structured display settings or a free-form JSON config.

Inputs

  • Client (required) — Select a client or enter its SmartProof ID (cl_…) or external ref.
  • Name (required) — Display name for the widget.
  • Location — Optionally select a location or enter its ID or external ref to limit the widget to that location; leave empty to include the client’s locations.
  • Additional Fields — Optionally set a visual style (defaults to Wall), filter reviews by tag labels, provide a JSON config object, or disable analytics, JSON-LD/SEO data, local storage cache, or SmartProof branding.
  • Display Settings — Optionally set common config options such as card layout and avatar size, review rating and count limits, centering, or notification toast behavior. These settings are merged into the config; use Config JSON for other options.

Output shape

A single item containing the created widget record as JSON.

The API response is returned for each input item. If Continue On Fail is enabled, a failed item instead returns JSON with an error field. Config JSON must be valid; structured settings override matching raw config keys, and disabled feature flags are applied last.

Links

Discussion