Embedding

Embedding Testimonials

Learn how to easily embed testimonials on your website with Retold.me

Quick Setup

Embed testimonials in less than 2 minutes with our simple two-line code snippet.

Overview

Our embedding system allows you to showcase testimonials on your website with minimal setup. The process involves adding a JavaScript script to your page and placing a simple div element where you want the testimonials to appear.

The embedded widget is responsive and will adapt to your website's design while maintaining the authentic look of your customer testimonials.

Step-by-Step Guide

1

Create a Widget

First, create a widget in your dashboard. This allows you to customize how your testimonials appear and which ones to display.

2

Add the Script

Add the following script tag to the <head>section of your webpage:

<script src="https://widget.retold.me/embed.js?publishable_key=YOUR_PUBLISHABLE_KEY" async></script>

Replace YOUR_PUBLISHABLE_KEY with your actual publishable key.

3

Add the Container

Place the following div element where you want the testimonials to appear:

<div id="retoldme-widget" data-widget="YOUR_WIDGET_ID"></div>

Replace YOUR_WIDGET_ID with the ID of the widget you created in step 1.

Complete Example

Here's a complete HTML example showing how to embed testimonials:


<!-- Testimonial Widget Container -->
<div id="retoldme-widget" data-widget="YOUR_WIDGET_ID"></div>
                
<!-- Retold.me Embed Script -->
<script src="https://widget.retold.me/embed.js?publishable_key=YOUR_PUBLISHABLE_KEY" async></script>

  
  
  
  

Customization Options

You can customize the appearance of your testimonial widget using data attributes. However, we recommend configuring these in your dashboard to maintain centralized control.

AttributeDescriptionDefault
data-sizeNumber of testimonials to display1
data-layoutLayout style (grid, slider)slider
data-themeColor theme (light, dark)light

Pro Tip

For easier maintenance, configure all appearance settings in your dashboard rather than using inline attributes. This allows you to update the look and feel of all your embedded testimonials at once.

Troubleshooting

Widget Not Appearing

  • Verify your publishable key is correct
  • Check that your widget ID is correct
  • Ensure the script is loaded before the div element
  • Make sure your testimonials are published

Styling Issues

  • The widget is responsive and should adapt to its container
  • For custom styling, use the dashboard configuration options
  • Contact support if you need advanced customization

Best Practices

Placement

Place testimonials near conversion points like signup forms, pricing pages, or product descriptions.

Visibility

Ensure testimonials are prominently displayed and easy to read on all devices.

Updates

New testimonials will appear automatically once published in your dashboard.