Skip to main content
Widgets are embeddable components that display your reviews on external websites via an embed code snippet. Choose from multiple layout types to match your website design. For a standalone hosted page with its own URL, use Wall of Love instead.

​
Available Tools

​
Available Layouts

Pass the layout as the numeric type when calling create_widget. Masonry Grid is the default.
The layout cannot be changed after a widget is created. To switch layouts, create a new widget instead.Feedspace also offers Floating Badge, Review Badge, and Review and Ratings widgets in the dashboard, and none of the three can be created through the MCP server. Floating Badge and Review Badge aggregate a review source instead of taking a hand-picked list, which is why create_widget cannot express them. Build all three in the Feedspace dashboard.
Ask for an unsupported layout and you get a substitute, not an error. Requesting a Floating Badge widget produces a Floating Cards one, created successfully and reported as done, because the assistant picks the closest available layout rather than refusing.Use a name from the table above, and if you are unsure what you got, ask “what layout type is that widget?” before embedding it.
Leave reviews out and the widget fills itself. Creating a widget without naming which reviews to include pre-fills it with your 4 most recent. Pass the reviews you want, or say how many, if that is not what you are after.

​
Which Tool Gives Which Numbers

  • get_widget_stats returns the view count only.
  • list_widgets returns view_count and engagement_rate for every widget, plus automation_filters_enabled and the embed_domains the widget has actually been embedded on.
If you want engagement rate or want to see where a widget is embedded, use list_widgets.
list_widgets returns every widget, including Floating Badge, Review Badge, and Review and Ratings. You can list, read, and share those, you just cannot create them with create_widget.

​
Customizing a Widget

update_widget accepts a customization object covering everything in the dashboard’s widget editor: layout toggles, colours, fonts, shadows, borders, scroll speed and direction, the inline call-to-action, and custom CSS. Only the fields you pass change; every other setting is preserved. Fields that do not apply to the widget’s layout are ignored, so a marquee_speed sent to a Carousel is silently dropped.
A few settings are plan-gated: allow_custom_css (which enables custom_css, max 1500 characters) and allow_to_remove_branding.