Widget Documentation

Embed TestiPro testimonials on any website with our lightweight JavaScript widget.

Quick Start

Add this code snippet to any page where you want testimonials to appear:

<div id="testipro-widget" data-slug="your-slug" data-style="carousel"></div>
<script src="https://your-domain.com/embed.js" async></script>

Replace your-slug with your workspace slug found in the dashboard.

Widget Styles

`carousel`

Rotating slideshow that cycles through approved testimonials. Great for hero sections.

`grid`

Responsive grid layout showing multiple testimonials at once. Ideal for dedicated testimonial pages.

`badge`

Compact badge showing average rating and testimonial count. Perfect for footers and sidebars.

`popup`

Floating button that opens a popup with testimonials. Non-intrusive social proof.

`marquee`

Continuous scrolling ticker of testimonial quotes. Eye-catching for landing pages.

Configuration Options

Configure the widget using data attributes on the container element:

Attribute	Required	Description
`data-slug`	Yes	Your workspace slug
`data-style`	Yes	carousel, grid, badge, popup, or marquee
`data-limit`	No	Max testimonials to show (default: 10)
`data-theme`	No	light or dark (default: light)

Example: Grid Widget

<div
  id="testipro-widget"
  data-slug="demo"
  data-style="grid"
  data-limit="6"
  data-theme="light"
></div>
<script src="https://your-domain.com/embed.js" async></script>

Performance

The embed script is lightweight (~5KB gzipped) and loads asynchronously. It fetches testimonials from our API and renders them client-side. No jQuery or other dependencies required.

Troubleshooting

Ensure your workspace slug is correct
Only approved testimonials appear in widgets
Check browser console for CORS or network errors
The widget container must exist before the script loads