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

# Review widget customization

> Build and embed fully branded review widgets on your website to showcase customer feedback from Google and Facebook.

Customizing review widgets is a valuable strategy for leveraging customer feedback to improve your brand's online image and boost trust. The Review Widget Customization feature lets you tailor your review widgets to match your brand's style and cater to your audience's preferences.

## Accessing the widget builder

Navigate to **Reputation > Widgets**, then click **Create Widget** to start crafting your custom widget. You can also edit an existing widget or select a template from the **Templates** tab.

<Frame caption="The Widgets tab in Reputation — widget list with type and source options">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/hD-ppANqjXRzmsAJ/images/reputation-widget-types.png?fit=max&auto=format&n=hD-ppANqjXRzmsAJ&q=85&s=4f2911760c371c6688d7c4a2240d9ed3" alt="Widgets Tab" width="1629" height="451" data-path="images/reputation-widget-types.png" />
</Frame>

***

## Layout tab

The Layout tab determines the basic structure of your widget.

<AccordionGroup>
  <Accordion title="AI summary">
    Enable the AI summary to display a brief overview of your products or services based on customer reviews. Choose from **Short**, **Detailed**, or **Action-Oriented** formats, and decide whether to display it at the top of the widget or inline with individual reviews.

    <Frame caption="AI summary widget showing aggregated review insights">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/hD-ppANqjXRzmsAJ/images/reputation-widget-summary.png?fit=max&auto=format&n=hD-ppANqjXRzmsAJ&q=85&s=5d3919623f3c9813d8b012937d006ebb" alt="Layout AI Summary" width="486" height="535" data-path="images/reputation-widget-summary.png" />
    </Frame>
  </Accordion>

  <Accordion title="Review source">
    Choose where your reviews come from: Google My Business (GMB) or Facebook (FB).
  </Accordion>

  <Accordion title="Widget type">
    Choose from: **List**, **Masonry**, **Grid**, **Carousel**, **Slider**, **Flash**, or **Legacy**.

    <Frame caption="Review widget displaying individual review cards">
      <img src="https://mintcdn.com/hoopai-84ec0cdc/hD-ppANqjXRzmsAJ/images/reputation-widget-reviews.png?fit=max&auto=format&n=hD-ppANqjXRzmsAJ&q=85&s=335083b193dac76ccef0e52a943725bb" alt="Widget with review cards" width="487" height="334" data-path="images/reputation-widget-reviews.png" />
    </Frame>
  </Accordion>

  <Accordion title="Maximum reviews displayed">
    Specify the maximum number of reviews to show, and optionally filter by rating.

    <Warning>
      Do not use review rating filtering if you reside in a jurisdiction where it is prohibited (such as the United States).
    </Warning>
  </Accordion>

  <Accordion title="Powered by section">
    Toggle the "Powered by" attribution shown at the end of the widget.
  </Accordion>
</AccordionGroup>

***

## Content tab

In the Content tab, you can fine-tune how your widget looks:

* Enable the widget title and enter an engaging heading and description to encourage user interaction.
* Customize the header section to include or exclude the rating, total review count, and "Write a review" button.

***

## Appearance tab

The Appearance tab controls the visual style of your widget:

* Pick from ready-made themes (**Light** or **Dark**) or create a **Custom** theme.
* With a custom theme, adjust individual component colors: widget heading, review text, star ratings, background, and borders.
* Select fonts and accent colors that match your branding.

***

## Settings tab

The Settings tab lets you refine widget behavior:

* Toggle display of review dates and reviewer profile icons.
* Choose whether to exclude reviews that do not have written descriptions.
* Copy the embed code for your website directly from this tab.

***

## Saving and managing widgets

<Steps>
  <Step title="Name your widget">
    Give your widget a meaningful name for easy identification.
  </Step>

  <Step title="Save or publish">
    Choose to save the widget for future use or make it live on your website immediately.
  </Step>

  <Step title="Manage saved widgets">
    View all saved widgets in the **Saved Widgets** tab. Use the three-dot actions menu to edit, duplicate, or delete any widget.
  </Step>
</Steps>

<Note>
  Default widgets cannot be deleted. You must first create a new widget and assign it as the default before deleting the original.
</Note>

<Tip>
  Create multiple widgets with different layouts for different pages — for example, a Carousel for your homepage and a Grid for your dedicated reviews page.
</Tip>

***

## FAQs

<AccordionGroup>
  <Accordion title="Which review sources can widgets display?">
    Widgets can display reviews from Google My Business (GMB) or Facebook. Select the source in the **Layout** tab when building your widget. You cannot mix sources in a single widget — create separate widgets for each platform if needed.
  </Accordion>

  <Accordion title="Can I filter which reviews appear in the widget by star rating?">
    Yes. In the **Layout** tab, set a minimum star rating filter under **Maximum reviews displayed**. Note that rating filters may be prohibited in some jurisdictions (including the United States) — check your local regulations before enabling this option.
  </Accordion>

  <Accordion title="How do I embed a widget on my website?">
    Go to the **Settings** tab within the widget builder and copy the embed code. Paste it into the HTML of your website where you want the widget to appear.
  </Accordion>

  <Accordion title="Can I have multiple widgets on the same website?">
    Yes. Create as many widgets as needed and embed each one separately. Use different layouts (Carousel, Grid, List) for different pages to optimize engagement in each context.
  </Accordion>

  <Accordion title="Why can't I delete my default widget?">
    The default widget is protected to ensure your site always has a fallback. Create a new widget, set it as default, and then you can delete the previous default.
  </Accordion>

  <Accordion title="Will manually added reviews appear in the widget?">
    Yes. Reviews added via CSV upload or manual entry appear in your review widgets alongside organic reviews from connected platforms like Google and Facebook.
  </Accordion>
</AccordionGroup>