Adding a testimonial widget to your website is one of the highest-ROI changes you can make to a landing page. Studies consistently show that social proof increases conversions by 15-30% — and a well-placed widget takes about 2 minutes to set up.
This guide walks you through everything: picking the right widget type, setting it up, and embedding it on any platform.
Why a testimonial widget converts better than a static section
A static testimonial section you write into your HTML is fine — but it has three problems. First, it's hard to update without a deployment. Second, it doesn't adapt to your visitor (you can't easily A/B test which testimonials perform). Third, it gives no signal of ongoing social proof — the same three quotes sit there forever.
An embeddable testimonial widget solves all three. You manage testimonials from a dashboard, and they appear on your site automatically. Add a new customer quote today and it shows up within minutes, no code change needed.
The 6 widget types and when to use each
Not every widget type works equally well in every position. Here's how to choose:
A responsive masonry grid of all your testimonials. Best for showing volume of social proof.
Auto-rotates through testimonials. Great for keeping pages short while showing multiple reviews.
Appears after a configurable delay. Non-intrusive way to surface proof at the right moment.
Compact star rating badge. Shows your average score and review count — like a trust seal.
Horizontal scrolling ticker of short testimonial quotes. Works well as a social proof strip.
One testimonial, prominently displayed. Use your strongest quote in the highest-attention spot.
Step 1: Collect testimonials first
Before embedding anything, you need testimonials. The fastest way is a collection form with a public link — send it to 3-5 happy customers by email and ask for a quick review. Most will respond within 24 hours.
In ShipPulse, your collection form is ready the moment you create a project. Share the link. When a customer submits a testimonial, you approve it and it immediately becomes available to display in any widget.
Step 2: Create a widget
In your ShipPulse dashboard, go to Project → Testimonials → Widgets → Create widget. Choose a widget type, pick a theme (light / dark / auto), and configure display options — number of columns, autoplay speed, whether to show star ratings, and so on.
The preview updates live as you change settings. No need to deploy to see what it looks like. For detailed configuration options, see the widget documentation.
Step 3: Embed with one script tag
Copy the embed code. It looks like this:
<script src="https://cdn.shippulse.dev/widget.js"
data-project="proj_your_id"
data-widget="testimonials-wall">
</script>Paste it anywhere in your HTML — before the closing </body> tag is standard. That's it. The widget renders itself inside a Shadow DOM container, so it never conflicts with your site's CSS.
Platform-specific instructions
Next.js
Use Next.js's built-in <Script> component with strategy="lazyOnload":
import Script from 'next/script'
<Script
src="https://cdn.shippulse.dev/widget.js"
data-project="proj_your_id"
data-widget="testimonials-wall"
strategy="lazyOnload"
/>WordPress
Go to Appearance → Theme Editor → footer.php and paste the script tag before </body>. Or use a plugin like "Insert Headers and Footers" to add it without editing theme files.
Webflow
In the page settings, scroll to Custom Code → Before </body> tag and paste the script. It works on any Webflow page instantly.
Shopify
Edit your theme.liquid file and paste the script just before </body>. For product pages, you can use Shopify's section schema to control visibility.
Best practices
- Put your highest-converting widget above the fold — a Carousel or Single Card in the hero section consistently outperforms a Wall of Love buried lower on the page.
- Use the Popup widget on high-intent pages — pricing pages, checkout pages, and trial signup pages. A popup that appears after 15 seconds with a strong testimonial can recover hesitating visitors.
- Match widget theme to your site — use
theme="auto"to respect the visitor's OS dark mode preference automatically. - Update testimonials regularly — fresh reviews signal an active product. Rotate in new quotes monthly.
How long does it actually take?
From zero to embedded widget: about 2 minutes once you have at least one approved testimonial. The embed code is one tag. The hardest part is collecting the testimonials themselves — and ShipPulse's collection form makes that as easy as sharing a link.