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
Create a Widget
First, create a widget in your dashboard. This allows you to customize how your testimonials appear and which ones to display.
Add the Script
Add the following script tag to the <head>section of your webpage:
Replace YOUR_PUBLISHABLE_KEY with your actual publishable key.
Add the Container
Place the following div element where you want the testimonials to appear:
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.
| Attribute | Description | Default |
|---|---|---|
data-size | Number of testimonials to display | 1 |
data-layout | Layout style (grid, slider) | slider |
data-theme | Color 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.