Developers

The @kudoso/react package

Embed a testimonial wall in a React or Next.js app as a native component.

If you are building with React or Next.js, @kudoso/react is a cleaner fit than the embed script. It renders the same testimonial wall as a real React component, with props instead of data- attributes.

Installation#

bash
1npm install @kudoso/react

Basic usage#

Import the testimonial wall component and give it your campaign ID:

jsx
1import { TestimonialWall } from '@kudoso/react';
2

3export default function Reviews() {
4  return <TestimonialWall campaignId="YOUR_CAMPAIGN_ID" />;
5}

The component fetches your campaign's approved testimonials from the embed API and renders the wall.

Configuration#

The package mirrors the embed widget, so the same ideas apply as props: layout, theme, accent color, column count, and which card details to show. A configured example:

jsx
1<TestimonialWall
2  campaignId="YOUR_CAMPAIGN_ID"
3  theme="dark"
4  layout="masonry"
5  columns={3}
6  accent="#10b981"
7/>

Note

@kudoso/react is an open-source package that tracks the embed widget. For the exact component name, the full prop list, and the version you have installed, check the package's README on npm. This page covers the concepts; the package README is the authoritative API reference.

When to use the package vs the script#

Use the packageUse the script
React or Next.js appWebflow, WordPress, Shopify, static HTML
You want props and typesYou want one line of HTML
The wall is part of your component treeThe wall drops into a CMS block

Both render the same wall from the same approved testimonials. Pick whichever matches how the host site is built.

Next steps#