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

# Create your first testimonial widget

> Learn how to create a widget in KudosWall, adjust its settings in the Widget Editor, and copy the embed code to display testimonials on your site.

Widgets are the embeddable displays you add to your website to show your approved testimonials. Each widget has its own settings — layout, theme, filters, and branding — and is tied to your workspace's approved testimonials. You can create as many widgets as you need.

<Steps>
  <Step title="Go to Dashboard > Widgets">
    In the left sidebar, click **Widgets** under your workspace.
  </Step>

  <Step title="Click New Widget">
    Click the **New Widget** button at the top of the Widgets page.
  </Step>

  <Step title="Enter a name for your widget">
    Give your widget a name. This is an internal label — your visitors won't see it — so use something that helps you identify the widget later, such as "Homepage — Hero" or "Pricing Page".
  </Step>

  <Step title="Your widget is created with default settings">
    KudosWall creates your widget immediately with sensible defaults: a **grid** layout, **light** theme, and a maximum of **20** testimonials displayed.
  </Step>

  <Step title="Click your widget to open the Widget Editor">
    Select the widget from your list to open the Widget Editor. You'll see a live preview on the right and settings on the left.
  </Step>

  <Step title="Adjust settings to match your site">
    Change the layout, theme, display options, filters, and branding. The preview updates in real time as you make changes, so you can see exactly how the widget will look before you publish it.
  </Step>

  <Step title="Copy your embed code">
    Switch to the **Embed Code** tab inside the Widget Editor. Copy the `<script>` tag shown there and paste it into your site's HTML wherever you want testimonials to appear.
  </Step>
</Steps>

<Note>
  Each workspace can have multiple widgets. Use different widgets for different pages or audiences — for example, one widget filtered to the "enterprise" tag for your enterprise landing page, and a separate widget on your homepage that shows your highest-rated reviews.
</Note>

## Next steps

<CardGroup cols={2}>
  <Card title="Widget Settings" icon="sliders" href="/widgets/widget-settings">
    Explore every layout, filter, and branding option available in the Widget Editor.
  </Card>

  <Card title="Embed Code" icon="code" href="/widgets/embed-code">
    Learn how to copy and place your widget's embed code.
  </Card>

  <Card title="Install Guides" icon="wrench" href="/widgets/install-guides">
    Step-by-step instructions for HTML, React, Webflow, and Shopify.
  </Card>

  <Card title="Plans & Pricing" icon="credit-card" href="/account/plans-pricing">
    Compare plans to unlock masonry, carousel, and badge removal.
  </Card>
</CardGroup>