Embedding a widget

Add your testimonials to any page with one script tag. Works on Shopify, Squarespace, Wix, WordPress, and any site that lets you add HTML.

The embed snippet

Every widget you create gets a unique embed snippet. Find it in your dashboard under Widgets → [your widget] → Get embed code.

It looks like this:

<script src="https://widget.socialproof.dev/widget.js"
  data-widget-id="YOUR_WIDGET_ID"></script>

Paste this snippet anywhere in your page's HTML. Vouch renders the widget automatically when the page loads.

One snippet, any page. You can embed the same widget on multiple pages, or create different widgets for different contexts — e.g. a carousel for your homepage, a grid for your testimonials page.

Platform guides

Shopify

You can add a Vouch widget to any Shopify page using the Custom HTML block in the theme editor.

From your Shopify Admin, go to Online Store → Themes → Customize
Navigate to the page where you want the widget (e.g. your homepage)
Click Add block → Custom HTML (or Custom content depending on your theme)
Paste your Vouch embed snippet into the HTML field
Click Save

For product pages, use the Custom Liquid block (available in OS 2.0 themes) and paste the snippet there.

Squarespace

Open the Squarespace page editor and click where you want the widget
Click the + button to add a block, and choose Code
Paste your Vouch embed snippet into the code block
Click Apply and Save

Note: Code blocks require a Squarespace Business plan or higher. On personal plans, you can still use the embed via Settings → Advanced → Code Injection to add it site-wide.

Wix

In the Wix editor, click Add (+) → Embed → Embed a Widget
Click Enter Code and paste your Vouch embed snippet
Click Update and position the embed block on your page
Click Publish

WordPress

Block editor (Gutenberg):

Edit the page or post where you want the widget
Click the + button and search for Custom HTML
Paste your Vouch embed snippet into the block
Click Update or Publish

Classic editor:

Edit the page or post
Switch to the Text tab (not Visual)
Paste your snippet where you want the widget to appear
Save

Custom HTML

Any HTML site

Paste the snippet anywhere inside your HTML file. The widget renders where you place it:

<!-- Your existing content -->
<section id="testimonials">
  <h2>What customers say</h2>
  <script src="https://widget.socialproof.dev/widget.js"
    data-widget-id="YOUR_WIDGET_ID"></script>
</section>

The widget is responsive and will adapt to any container width.

Widget types

Carousel — rotating testimonials, great for homepages and hero sections
Grid — 2–4 column grid, great for dedicated testimonials pages
Single — one testimonial at a time, great for tight spaces and sidebars
Wall — masonry wall of testimonials, great for social proof pages
Badge — compact floating badge, great for landing pages

Create and configure your widgets from the Widgets section of your dashboard.

The widget updates automatically

When you approve new testimonials in your dashboard, they appear in all your active widgets without any changes to your embed code. No re-embedding, no cache clearing needed.

Need help embedding?

Email us and we'll help you get it live. Free accounts included.

[email protected]