A highlighted quote with attribution.
Live example
These are real Testimonial blocks rendering on this page right now. Tab to them and try them in both color schemes.
Replace this quote with words a real customer actually said. Keep it short, keep it concrete, and always ask before you attribute.
Alex Rivera
Director of Digital Services
Example Corp
Dark mode you don’t have to build
Every block supports dark mode. Use the light/dark toggle in the header and the live example above switches with it.
Parameters
Everything the Testimonial block accepts. Setting is the label you see in the block’s settings panel. Parameter is what the same value is called in code. Accepts is what you can put in it.
| Setting | Parameter | Type | Default | Accepts | What it does |
|---|---|---|---|---|---|
| Typed on the block | quote | string | empty | Any text | The quotation. Use only words a real person said, and get their permission before you name them. |
| Typed on the block | authorName | string | empty | Any text | Who said it. |
| Typed on the block | authorRole | string | empty | Any text | Their role. |
| Typed on the block | authorOrg | string | empty | Any text | Their organization. |
| Upload avatar | authorAvatarUrl | string | empty | A URL | An optional photo. |
| Avatar alt text | authorAvatarAlt | string | empty | Any text | The photo’s alt text. Required when a photo is set. |
| Quotation mark | markStyle | string | “double-curved” | none, single-curved, double-curved, double-straight | The quotation mark drawn before the quote. |
| Quote size | quoteSize | string | “lg” | md, lg, xl | The quote’s type size. |
| Attribution layout | attributionStyle | string | “stacked” | stacked, inline | The attribution stacked under the quote or inline after it. |
| Kind | kind | string | “plain” | plain, card | Plain, or on a card background. |
| URL | href | string | empty | A URL | The URL this points to. |
| Link text | linkText | string | “Read the full story” | Any text | The text of the link to where the quote can be read in full. Make it clear on its own. |
| Open in new tab | target | string | empty | empty, _blank | Where the link opens, for example _blank for a new tab. A link that opens a new tab tells screen reader users so. |
| Link relationship | rel | string | empty | Any text | The link’s rel attribute, for example nofollow. Set it only when you need to control it yourself. |
| Trailing icon | iconName | string | empty | A Carbon icon name | The name of a Carbon icon, for example download. The icon is decorative, so the text must still carry the meaning. |
| Alignment | align | string | “start” | start, center | How the content aligns. |
Accessibility parameters, on this and every AWT block
Every AWT block has an Accessibility panel in its settings. Each control in it becomes a real HTML attribute on the block’s outer element:
| Setting | Parameter | What it does |
|---|---|---|
| Accessible name (aria-label) | ariaLabel | Becomes aria-label on the block’s outer element. Replaces the accessible name screen readers announce. Set it only when the visible label is not enough. |
| Described by (aria-describedby) | ariaDescribedby | Becomes aria-describedby. Point it at the ID of another element on the page whose text adds a longer description. |
| Labelled by (aria-labelledby) | ariaLabelledby | Becomes aria-labelledby. Point it at the ID of another element whose text should become this block’s accessible name. |
| Role | awtRole | Becomes the role attribute. Overrides the element’s ARIA role. The list offers only roles that suit the element. |
| Language (lang) | awtLang | Becomes the lang attribute. Set it when this block’s content is in a different language from the page, as a BCP-47 code like “fr”. |