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

# Get started with KudosWall

> Go from zero to your first embedded testimonial widget in six steps. Collect a testimonial and display it on your website — no coding knowledge required.

This guide walks you through collecting your first testimonial and displaying it on your website. By the end you will have a live widget showing approved testimonials on any page you choose.

<Note>
  The Free plan supports up to 5 testimonials and 1 project. Upgrade to Pro for unlimited testimonials, custom domains, and white-label branding.
</Note>

<Steps>
  <Step title="Create your account">
    Go to [kudoswall.org](https://kudoswall.org) and sign up for a free account. Once you confirm your email, KudosWall creates a default workspace for you automatically. A workspace is the container for all your projects, testimonials, and widgets.
  </Step>

  <Step title="Create a collection page">
    In your dashboard, go to **Collections** and click **New Collection**. Give the collection a name — this is only visible to you — then click **Create**.

    KudosWall generates a public collection page where your customers can submit testimonials. The collection customizer opens automatically, where you can adjust the headline, subheading, colors, font, and form fields.
  </Step>

  <Step title="Share your collection link">
    In the collection customizer, click the **Share** tab. You'll see your collection link in the format:

    ```
    https://kudoswall.org/collect/{your-slug}
    ```

    Copy this link and send it to customers via email, a post-purchase message, or any other channel where you already communicate with them.
  </Step>

  <Step title="Approve a testimonial">
    When a customer submits their testimonial, it appears in your dashboard under **Testimonials** with a status of **Pending**.

    Click on the submission to read it, then click **Approve** to make it eligible for display in your widgets. Testimonials are never shown publicly until you approve them.

    <Tip>
      Approve a test submission by opening your collection link in a browser and filling out the form yourself.
    </Tip>
  </Step>

  <Step title="Create and embed a widget">
    Go to **Dashboard** > **Widgets** and click **New Widget**. Give your widget a name, then open it to choose a layout (grid, masonry, or carousel), pick a theme, and configure any filters.

    Once the widget is created, click **Embed Code** to find your script tag:

    ```html theme={null}
    <script
      src="https://kudoswall.org/widget.js"
      data-id="YOUR_WIDGET_ID"
      async
    ></script>
    ```

    Click **Copy Code** to copy it to your clipboard.
  </Step>

  <Step title="Add the widget to your website">
    Open your website's HTML and paste the script tag just before the closing `</body>` tag. The widget loads asynchronously and will not affect your page's load performance.

    ```html theme={null}
    <!-- your existing content -->
    <script
      src="https://kudoswall.org/widget.js"
      data-id="YOUR_WIDGET_ID"
      async
    ></script>
    </body>
    ```

    Save and publish your page. The widget will appear automatically and update whenever you approve new testimonials in your dashboard.

    <Tip>
      If you use a website builder like Webflow, Squarespace, or Shopify, paste the script into your theme's custom code or footer injection field rather than editing HTML directly.
    </Tip>
  </Step>
</Steps>

## What's next?

<CardGroup cols={2}>
  <Card title="Customize your collection page" icon="palette" href="/collecting/customize-branding">
    Change colors, fonts, and form fields to match your brand identity.
  </Card>

  <Card title="Manage testimonials" icon="check" href="/managing/review-approve">
    Learn how to tag, pin, archive, and export your testimonials.
  </Card>

  <Card title="Widget settings" icon="sliders" href="/widgets/widget-settings">
    Fine-tune layouts, themes, filtering, and display options for your widget.
  </Card>

  <Card title="Plans & Pricing" icon="credit-card" href="/account/plans-pricing">
    Compare plans and upgrade to unlock unlimited testimonials and custom domains.
  </Card>
</CardGroup>
