# Testimonials, list

- **[Sections](/blocks/)**
- **[Testimonials](/blocks/testimonials/)**
- **Testimonials, list**

A plain heading above a single column of quotes in ruled rows, each with a small round portrait beside the quote and the speaker under it; on a phone the portrait sits…

## Import

- **CLI**

  ```
  npx shadcn add https://ui.klarhimmel.com/r/testimonials-list.json
  ```
- **Import**

  ```
  import Block from '@/components/klarhimmel/blocks/testimonials-list';
  ```

Also called

- testimonials/list

- **About**: A plain heading above a single column of quotes in ruled rows, each with a small round portrait beside the quote and the speaker under it; on a phone the portrait sits above the quote.
- **Category**: What customers say, one quote or many. New project? Set it up once: /get-started/installation.

## Notes

- **When to use it**: A plain heading above a single column of quotes in ruled rows, each with a small round portrait beside it and the speaker under it. Use `testimonials-grid` for cards.
- **Writing for it**: - Write each quote as one or two sentences, the way the speaker said it.
- Put the name and then the role on one line, so the row stays compact.
- Add a portrait for every row or for none, because a mix of faces and gaps looks unfinished.
- **Watch out for**: On a phone the portrait sits above the quote, which adds height to every row. A long list becomes a long scroll, so keep to a handful.

## Pairs well with

- **[Hero, centered](/blocks/hero/centered)**
- **[Logos strip](/blocks/logo-cloud/row)**
- **[Call to action, band](/blocks/cta/banner)**

## Usage

The block in a page, with its default content (long lists shortened). Every prop is in the table below.

section.tsx

```
import { Theme } from '@/components/klarhimmel/theme/style';
import { BlockSurface } from '@/components/klarhimmel/blocks/surface';
import TestimonialsList from '@/components/klarhimmel/blocks/testimonials-list';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <TestimonialsList props={{
          "title": "Say what these quotes are about",
          "items": [
            {
              "quote": "Write one short quote the speaker would stand behind.",
              "byline": "Name, role and company",
              "media": {
                "src": "/pictures/avatar-6.svg",
                "alt": "A portrait of a person",
                "srcDark": "/pictures/avatar-6-dark.svg"
              }
            },
            {
              "quote": "Write a fuller quote about what changed for the speaker and how it felt.",
              "byline": "Name, role and company",
              "media": {
                "src": "/pictures/avatar-1.svg",
                "alt": "A portrait of a person",
                "srcDark": "/pictures/avatar-1-dark.svg"
              }
            },
            {
              "quote": "Write one short quote the speaker would stand behind.",
              "byline": "Name only",
              "media": {
                "src": "/pictures/avatar-2.svg",
                "alt": "A portrait of a person",
                "srcDark": "/pictures/avatar-2-dark.svg"
              }
            }
          ]
        }} />
      </BlockSurface>
    </Theme>
  );
}
```

## Props

The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.

- **title**: Text, up to 80 characters.
- **items**: List of 1 to 6. Each item: quote, byline, media.
- **headingLevel**: One of '1', '2'. Optional; empty is not rendered.

[Previous](/blocks/testimonials/grid)

[Next](/blocks/testimonials/rating)
