Skip to Content

TestimonialsSection

Present attributed customer quotes, ratings, logos, avatars, and media in responsive testimonial layouts.

TestimonialsSection renders customer statements with required attribution. Items require a stable id, quote, and author; role, organization, avatar, company logo, rating, media, and featured styling are optional.

Beta API maturity: Beta.

Installation

import { TestimonialsSection, type TestimonialItem } from "@puzzle-ui/pieces";

Variant previews

The carousel includes labeled buttons and supports left/right arrow keys while its navigation group is focused. Ratings are read-only and use the UI Rating primitive.

grid - A balanced set of customer quotes.

390 × 844

cards - Testimonials shown as distinct cards.

390 × 844

carousel - A keyboard-navigable featured quote at a time.

390 × 844

featured - One highlighted testimonial with supporting quotes.

390 × 844

quote - A single quote with restrained framing.

390 × 844

masonry - Testimonials with varied quote lengths.

390 × 844

split - Quotes paired with an adjacent introduction or media.

390 × 844

video - Testimonials that include consumer-provided video.

390 × 844

avatar-grid - A collection emphasizing customer identity.

390 × 844

wall - A dense wall of short customer endorsements.

390 × 844

minimal - A low-decoration quotation list.

390 × 844

editorial - Longer quotations with stronger typography.

390 × 844

rating - Testimonials that include a customer rating.

390 × 844

dark - Quotes on a contrasting dark surface.

390 × 844

API

PropTypeDescription
variantTestimonialsVariantSelects one of fourteen testimonial compositions; defaults to grid.
itemsreadonly TestimonialItem[]Attributed quote data.
TestimonialItem.quoteReactNodeRequired quote content.
TestimonialItem.authorstringRequired author name.
TestimonialItem.ratingnumberOptional read-only rating.
TestimonialItem.avatar / companyLogoReactNodeOptional consumer-provided identity nodes.
TestimonialItem.mediaReactNodeOptional image, video, or other media.
carouselLabelstringAccessible carousel name; defaults to Customer testimonials.
Shared section propsSectionRootProps and heading propsSemantic root, theme, native attributes, heading, actions, and children.

Usage

<TestimonialsSection
  variant="carousel"
  title="What customers say"
  items={[
    {
      id: "riley",
      quote: "The team can focus on work that matters.",
      author: "Riley Chen",
      role: "Product lead",
      organization: "Acme",
      rating: 5,
    },
  ]}
/>

The quote is rendered as a blockquote with attribution in its footer. Supply alternatives for meaningful media and ensure any consumer-provided avatar content does not repeat the visible author name.

Accessibility

Each quote is semantically attributed. Carousel controls have accessible names and support both buttons and arrow-key navigation. Ratings are read-only and labeled. Keep the author and organization text available even when logos or avatars are supplied.