> ## Documentation Index
> Fetch the complete documentation index at: https://docs.feedspace.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Widgets

> Tools for creating embeddable testimonial widgets for your website.

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](/mcp/tools/pages) instead.

## Available Tools

| Tool                       | Description                                                                               | Try asking                                                            |
| -------------------------- | ----------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
| `list_widgets`             | List all embeddable widgets in your workspace                                             | "Show me all my testimonial widgets"                                  |
| `get_widget`               | Get details of a specific widget                                                          | "Show me the details of my carousel widget"                           |
| `get_widget_share`         | Get the embed code snippet to paste into your website                                     | "Give me the embed code for my testimonial widget"                    |
| `get_widget_stats`         | See how many times a widget has been viewed                                               | "How many views has my testimonial widget received?"                  |
| `create_widget`            | Create a new widget with your chosen layout and reviews                                   | "Create a carousel widget with my 5-star reviews"                     |
| `update_widget`            | Rename a widget, change which reviews it shows and their order, or restyle its appearance | "Restyle my carousel widget with a blue accent and rounded corners"   |
| `update_widget_automation` | Set auto-add rules so new matching reviews appear in the widget automatically             | "Automatically add any new 5-star video review to my carousel widget" |
| `replicate_widget`         | Duplicate a widget with all its settings and reviews                                      | "Duplicate my carousel widget"                                        |

## Available Layouts

Pass the layout as the numeric `type` when calling `create_widget`. Masonry Grid is the default.

| Type | Layout                 | Type | Layout                 |
| ---- | ---------------------- | ---- | ---------------------- |
| `4`  | Carousel               | `10` | Horizontal Scroll      |
| `5`  | Masonry Grid (default) | `11` | Floating Cards         |
| `6`  | Strip Slider           | `16` | Avatar Carousel Slider |
| `7`  | Avatar Group           | `17` | Cross Slider           |
| `8`  | Avatar Slider          | `18` | Company Logo Slider    |
| `9`  | Vertical Scroll        | `19` | Avatar Blocks          |

<Note>
  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](https://app.feedspace.io).
</Note>

<Warning>
  **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.
</Warning>

<Note>
  **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.
</Note>

## 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`.

<Note>
  `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`.
</Note>

## 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.

<Note>
  A few settings are plan-gated: `allow_custom_css` (which enables `custom_css`, max 1500 characters) and `allow_to_remove_branding`.
</Note>