Preview brand Custom

Testimonials

Quotes people have written about the business or its people, with who wrote them and when. No source, score or stars: for thank-you notes and letters rather than a review site.

Beta

What our clients say

Notes clients have sent us after a project. An example, to show the layout.

  • An example quote, set larger because it comes first: a sentence or two in the writer’s own words.

    Sample A.September 2026
  • Quotes are copied word for word. A long one is cut to a few lines with Read more, and prints whole.

    Sample B.August 2026
  • Who wrote it and when sit at the foot of each card, lined up across the row.

    Sample C.July 2026Example

What our clients say

Notes clients have sent us after a project. An example, to show the layout.

  • An example quote, set larger because it comes first: a sentence or two in the writer’s own words.

    Sample A.September 2026
  • Quotes are copied word for word. A long one is cut to a few lines with Read more, and prints whole.

    Sample B.August 2026
  • Who wrote it and when sit at the foot of each card, lined up across the row.

    Sample C.July 2026Example
Show code
js
# src/content/settings/testimonials.yaml (edited in Somnia CMS)
title: What our clients say
intro: Where the quotes come from
items:
  - text: Word for word…
    name: Sample A.
    date: 2026-09

// a page
<Testimonials />                 // all, the first one wide
<Testimonials limit={3} feature={false} link={{ href: '/about/#testimonials', label: 'Read them all' }} />

When to use it

  • The business has kind words it kept itself: thank-you notes, letters, a guest book.
  • You can say where they came from.

Use something else when:

  • They are reviews on a public site, with a score: Reviews.
  • It is one client’s story: a case study.

Testimonials or Reviews

Use Reviews for reviews on a public site (Google, Trustpilot), with their score and a link to read them all there. Use Testimonials for words the business has kept itself, such as thank-you notes or a guest book, and say where they come from in intro, so readers know what they're reading.

How it works

  • feature (on by default) sets the first quote across the row in the heading face; limit shows the first few, with link to a page with them all.
  • clamp cuts long quotes to that many lines with Read more (six by default); on paper they print whole.
  • A blank line in a quote starts a new paragraph. Dates are months (YYYY-MM).
  • Kept out of site search (data-pagefind-ignore), since the same quotes can appear on several pages.

Do and don't

Do

  • Copy quotes exactly, and ask before naming the people who wrote them
  • Say where the quotes come from

Don't

  • Present them as reviews from a public review site
  • Edit a quote to make it read better

Accessibility

What it does for you

  • A region named by its heading, an opening line saying where the words come from, then the quotes as a list.
  • Each quote is a figure: the quotation, then who wrote it and when.
  • The large quotation mark is decoration and isn’t read out.
  • A long quote is cut to a few lines with Read more, a real button that says whether the rest is showing. It is offered only when it would hide two lines or more, and the whole quote is printed.

What you need to do

  • Quotes copied exactly, and permission before naming who wrote them.
  • An opening line that says what these are: thank-you notes, a guest book.
  • A heading at the level the page’s outline needs (headingId when it is linked to).

Keyboard

KeyWhat it does
TabMoves to any Read more, and to the link to all of them.
Enter or SpaceOn Read more: shows the rest of that quote.

What a screen reader is told

  • A region with the heading’s name, and a list of however many quotes.
  • Each quote: a figure named by who wrote it and when, holding a quotation.

This is what the browser reports to assistive technology. What each screen reader then says varies, and has not been listened to yet.

WCAG 2.2

CriterionLevelHow this meets it
1.3.1 Info and RelationshipsAA list of figures, each a quotation with its caption.
2.1.1 KeyboardARead more is a native button.
4.1.2 Name, Role, ValueARead more says whether the rest is showing.

The criteria this component has a part in. A page that uses it still has to meet the rest.

Checked

CheckHowResult
Automated (axe-core)WCAG 2.0, 2.1 and 2.2 rules at A and AA, the page in light and in darkPassed
Nothing found, light or dark
Narrow screenNo sideways scrolling at 320px wide (WCAG 1.4.10)Passed
No sideways scrolling
Keyboard and what the browser reportsReal key presses on the live example, and the role, name and state given to assistive technologyPassed
5 of 5 checks pass
On paperSomnia’s print check: no overlaps, stranded headings or controls on the pagePassed
No faults on 6 sheets
Screen readerListened to by a person, in VoiceOver and NVDANot yet
Not yet checked by a person

The 5 checks made with the keyboard, on the example at the top of this page:

  • Passed It is a region named by its heading, holding a list with one item for each quote
  • Passed Each quote is a figure holding a quotation, named by who wrote it and when
  • Passed The large quotation mark is not reported to a screen reader
  • Passed A quote short enough to show whole has no Read more to tab to
  • Passed The opening line says where the words come from, before the quotes

Run by script on against Somnia DS 1.89.0, in Chromium with axe-core 4.14.0. How these checks work, and every component's results.

Not yet checked

  • How it sounds in a screen reader (VoiceOver, NVDA, TalkBack) has not been checked by a person. The roles, names and states the browser reports are checked by script; what is actually spoken is not.
  • Windows high contrast (forced colours) has not been looked at by a person.
  • The first quote is set larger. That is for the eye only: nothing tells a screen reader it is the featured one, and nothing needs to.

Evidence

Where it's used

WhereFor
Headland YachtingGuests’ notes to its owners: the first three on the home page, all of them on About.

What we saw, and what changed

WhenWhat we sawWhat changed
Headland had kind words from guests that were not reviews on any public site.A component of its own: quotes with who and when, no source, score or stars (1.34.0).
A business could take reviews off every page with their words kept, but not these.The same Show on the site switch (1.49.0).

From building and using it on real sites, each entry taken from the changelog or the build's own notes. This is observation by the studio and its clients, not research sessions with users.

What we don't know yet

  • Whether readers trust quotes a business chose itself as they do reviews on a public site is not known.