Widgets

Widget Embed Guide

Embed the ReputaFlow testimonial widget on any site and override defaults with simple data-* attributes.

1. Basic embed snippet

Drop this snippet on any page where you need testimonials. Replace YOUR_USER_ID with your dashboard ID.

<script src="https://reputaflow.com/widget.js" async></script>
<div data-rf-widget data-user="YOUR_USER_ID" data-layout="carousel"></div>

2. Supported layouts

LayoutWhat you getNotes
carouselSingle testimonial with arrows / auto-rotateDefault option
gridResponsive cards (up to 3 columns, collapses on mobile)Shows the latest 9 testimonials

The list layout is reserved for a future release.

3. Optional data attributes

AttributeTypeDescription
data-show-starsbooleanHide or show star ratings
data-show-attributionbooleanHide or show customer name / role
data-show-datesbooleanDisplay testimonial dates
data-auto-rotatebooleanEnable carousel auto-rotation
data-rotate-intervalnumber (ms)Interval between slides (3000–15000 ms)
data-limitnumberLimit the number of testimonials rendered
data-show-brandingbooleanForce hide/show the “Powered by ReputaFlow” footer

Booleans accept true/false, 1/0, yes/no.

4. Responsive behaviour

  • Grid layout collapses to 2 columns below 900 px and a single column below 640 px.
  • Carousel supports touch swipe gestures and pauses rotation on hover.
  • The container automatically scales down on narrow viewports (padding adjusts at 640 px).

5. Refresh helper

If you hydrate testimonials dynamically, call the exposed helper after the DOM updates:

window.ReputaFlowWidget?.refresh();

6. Troubleshooting

  • Widget not loading: verify data-user matches the ID in your dashboard and that the widget script is reachable.
  • Branding showing on paid plan: confirm the plan saved in settings; override per embed with data-show-branding="false" if needed.
  • Layout mismatch: clear conflicting attributes or regenerate the snippet from the dashboard.