Blockquote
Styled quotation block with optional attribution. Built on the native <blockquote> element with classless styling, plus a mirror class for consumers who cannot use the element directly. Supports typographic quote marks controlled by a token so the team can opt into or out of curly quotes per theme.
Usage
When to use
- Pulling out a quote from an interview, report, or external source
- Editorial highlight where a reader's attention should be drawn to a cited statement
- Testimonials and case study quotes
When not to use
- For inline short quotes - use
<q>instead - For purely decorative emphasis without attribution - use a callout or section
- For code or pre-formatted output - use the code component
Do
- Attribute the quote using
<footer><cite> - Keep the quote concise and faithful to the source
- Let typography tokens handle the visual styling
Don't
- Nest headings inside a blockquote
- Use blockquote as a styling hook for generic indented content
- Omit attribution for quotes taken from external sources
API
Slots
| Slot | Required | Description |
|---|---|---|
content | Yes | The quotation text. |
Props
| Prop | Type | Default | Description |
|---|---|---|---|
author | string | - | Optional attribution shown below the quote. |
classes | array | - | Additional CSS class words merged into the root element. |
attributes | object | - | Additional HTML attributes spread on the root element. |
Classes
| Class | Capability | Default | Description |
|---|---|---|---|
.subtle | Emphasis | - | Lower emphasis; a muted, quieter weight. |
.neutral | Emphasis | Yes | Default emphasis; the standard weight at balanced contrast. |
.accent | Emphasis | - | Higher emphasis; a stronger, louder weight. |
.sm | Size | - | Small. |
.md | Size | Yes | Medium. |
.lg | Size | - | Large. |
Examples
Default
Standard blockquote with attribution.
Without attribution
Blockquote without the footer attribution.
Accessibility
- WCAG 2.2 AA
<blockquote>provides semantic meaning natively.- Attribution uses
<cite>inside<footer>so assistive tech can associate the citation with the quote. - Color contrast for muted footer text must meet AA.