Skip to main content

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​

SlotRequiredDescription
contentYesThe quotation text.

Props​

PropTypeDefaultDescription
authorstring-Optional attribution shown below the quote.
classesarray-Additional CSS class words merged into the root element.
attributesobject-Additional HTML attributes spread on the root element.

Classes​

ClassCapabilityDefaultDescription
.subtleEmphasis-Lower emphasis; a muted, quieter weight.
.neutralEmphasisYesDefault emphasis; the standard weight at balanced contrast.
.accentEmphasis-Higher emphasis; a stronger, louder weight.
.smSize-Small.
.mdSizeYesMedium.
.lgSize-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.
  • code - block-level pre-formatted content
  • callout - non-quoted editorial emphasis