Docs

Get started in 5 minutes

Everything you need to collect and display testimonials on your site. If something's missing here, email us — we'll update this page the same day.

1

Create a collection form

Sign up at testimoni.io/signup. On first login you land on the collect page — just give your form a name (e.g. "Customer Feedback") and click Create.

Free plan gets 1 form. Pro unlocks unlimited forms — one per channel (post-purchase, onboarding, support, etc.).

2

Share the form

Every form gives you five channels:

  • Direct link — paste in emails, DMs, Slack.
  • Embed script — floating "Leave a Review" button on your site. One-line install.
  • iFrame — full form on a dedicated URL you can iframe anywhere.
  • Email template — pre-written post-purchase email.
  • QR code — for print, packaging, in-store.

Grab any of these from /dashboard/collect after creating a form.

3

Approve submissions

New submissions land in /dashboard/inbox. Review each one, click Approve to add it to your testimonial library or Reject to discard.

Approved testimonials are available to any widget you build. Rejecting doesn't delete — you can flip a decision later.

4

Build a widget

Go to /dashboard/widgets, click Create Widget, pick a layout (Grid, Masonry, Carousel, List, or Marquee — Pro plans get all five), and drag in the testimonials you want to feature.

Free plan: 1 widget, Grid layout only. Pro: unlimited widgets, every layout.

5

Embed on your site

From the widget page, grab your embed script:

<script src="https://testimoni.io/embed/widget.js" data-widget-id="wgt_XXXXXXXX"></script>

Paste it into any page. Works on Framer, Webflow, WordPress, Shopify, Next.js, React, Vue — or plain HTML. Shadow DOM isolation ensures zero CSS conflicts with your site.

API reference

Testimoni ships a public widget API at /api/widget/[widgetId] (JSON, publicly readable, 5-minute CDN cache) and a collect API at /api/collect/[formId]. Both are stable — build your own custom renderer if the default layouts don't fit your site.

Full API docs and REST authentication are coming. For now, email us if you need programmatic access.

Try it live

See the full collect → approve → embed flow. No sign-up required.

Open the demo