Docs

Main site

Installation Browser support Extend config MCP server
Validation Page speed testing Responsive design
Accordion Aspect Ratio Avatar Badge Banner Bento Grid Blockquote Breadcrumbs Button Callout Card Drawer Dropdown Link Modal Navbar Navblock Pagination Popover Progress Separator Tabs Timeline Toast Tooltip
Checkbox Datepicker File upload Form field Input Label OTP Radio Range Select Textarea Toggle
Header Footer
Accordion Auth Checkbox & Radio Content Drawers Features Modals Statistics & Metrics Teams Dropdowns
Address Contact number Currency symbol Date Emirates ID Name
Close
Home Documentation Components Blockquote

Blockquote

A Blockquote presents quoted text with an optional citation and author attribution. It renders a native "<blockquote>" element in a primary appearance (with a decorative quotation mark) or a colored appearance (a tinted panel instead of the icon).

Content Display
Status
Active
Introduced
4.0.x
View source code

Anatomy

The aegov-blockquote component renders a single native <blockquote> element. The primary (default) appearance shows a decorative quotation-mark icon; the colored appearance replaces it with a tinted background and a colored start-edge border instead. An optional footer holds the author and authorTitle, shown only when at least one is set.

Image showing anatomy of a blockquote

Item Name Description
1 Quotation mark (primary only) A decorative SVG icon, hidden entirely in the colored appearance
2 Quote content The slotted quotation text
3 Footer (optional) Shows author and/or authorTitle; only rendered when at least one is set

Options

Appearance

primary (default) shows the decorative quotation mark. colored replaces the icon with a tinted background panel and a colored start-edge border.

primary (default)

Digital government is not about technology. It is about making services simple enough that people do not need to think about them.

colored

Digital government is not about technology. It is about making services simple enough that people do not need to think about them.
<aegov-blockquote appearance="primary">…</aegov-blockquote>
<aegov-blockquote appearance="colored">…</aegov-blockquote>

Attribution

author names the person or source; authorTitle gives their role. Both are optional, but a quote with no attribution rarely carries weight in a government context.

Author and title

Provide author alone, author with authorTitle, or neither — the footer is only rendered when at least one of them is set, so an unattributed quote renders with no empty footer space.

We reduced the renewal journey from eleven steps to four. The remaining four are the ones that actually need a person. The service told me exactly what I needed before I started. That is the whole difference. Every federal service should be usable on a phone, in either language, by anyone.
<!-- Full attribution -->
<aegov-blockquote author="Ahmed Al Mansouri" author-title="Director of Digital Services">…</aegov-blockquote>

<!-- Author only -->
<aegov-blockquote author="Ahmed Al Mansouri">…</aegov-blockquote>

<!-- No attribution -->
<aegov-blockquote>…</aegov-blockquote>

Citing a source

cite takes the URL of the source and maps to the native cite attribute on the <blockquote> element. It is not visible — browsers do not render it, so it is machine-readable metadata only.

All federal services will be delivered digitally by default, with in-person channels retained for those who need them.
<aegov-blockquote
  cite="https://u.ae/en/about-the-uae/digital-uae"
  author="UAE Digital Government Strategy"
  author-title="2025–2030"
>
  All federal services will be delivered digitally by default, with in-person channels
  retained for those who need them.
</aegov-blockquote>

If readers should be able to reach the cited source, add a visible link after the quote — cite alone is never enough, since it is invisible to sighted users.

Extra classes

extraClass only applies margin/padding (spacing) utilities to the rendered <blockquote> element — e.g. mt-10. Width, colour, and every other visual utility have no effect (see the note above). To constrain reading width, put a width class on the host (class="max-w-3xl") or wrap the component in your own element instead.

Spacing above comes from extra-class. The comfortable reading width comes from the wrapping div, not extra-class.
<div class="max-w-prose mx-auto">
  <aegov-blockquote extra-class="mt-10" author="…">…</aegov-blockquote>
</div>

RTL support

The blockquote is direction-aware — text and attribution follow the reading direction automatically, and the decorative quotation mark stays anchored to the inline-start corner in both directions, with its shape horizontally mirrored so it opens the correct way in Arabic rather than appearing reversed.

الحكومة الرقمية ليست عن التقنية، بل عن جعل الخدمات بسيطة إلى حدٍّ لا يحتاج معه الناس إلى التفكير فيها. أخبرتني الخدمة بما أحتاجه بالضبط قبل أن أبدأ. هذا هو الفرق كله.
<div dir="rtl">
  <aegov-blockquote author="سعادة سارة الأميري" author-title="وزيرة دولة للتعليم العام">
    الحكومة الرقمية ليست عن التقنية، بل عن جعل الخدمات بسيطة إلى حدٍّ لا يحتاج معه الناس إلى التفكير فيها.
  </aegov-blockquote>
</div>

Mark a quote in a different language from the rest of the page with lang and dir on the host, so a screen reader switches voice correctly (WCAG 2.2 SC 3.1.2) — for example <aegov-blockquote lang="en" dir="ltr" author="…">An English quotation on an Arabic page.</aegov-blockquote>.

Common uses

A common use for a blockquote is a testimonial — pairing it with a card, often alongside others in a grid.

Testimonial cards

Pairing a blockquote with a card gives each testimonial a clear visual boundary — useful when showing several quotes together in a grid, as below.

What people said about the new service

The service told me exactly what I needed before I started. That is the whole difference. I renewed my card from my phone in four minutes, in Arabic.
<section>
  <h2 class="font-bold text-h4 mb-6">
    What people said about the new service
  </h2>

  <div class="grid gap-6 md:grid-cols-2">
    <aegov-card appearance="light" variant="neutral-min">
      <aegov-blockquote author="Fatima Al Suwaidi" author-title="Dubai">
        The service told me exactly what I needed before I started.
      </aegov-blockquote>
    </aegov-card>

    <aegov-card appearance="light" variant="neutral-min">
      <aegov-blockquote author="Omar Al Hashimi" author-title="Sharjah">
        I renewed my card from my phone in four minutes, in Arabic.
      </aegov-blockquote>
    </aegov-card>
  </div>
</section>

Usage

Here is the recommended usage of a blockquote on any website or application. These are recommended usage guides, however the developer must use the best practices of web and application development to accurately use this component.

Attribute the quote whenever practical

Set author (and authorTitle where the role adds weight). An unattributed quotation reads as an unsourced claim, especially in a government context.

Add a visible link when the source should be reachable

cite is machine-readable metadata only — it is never shown to sighted users. Pair it with a visible link after the quote if readers need to reach the source.

Keep quotations to a comfortable reading width

Roughly 60–100 characters per line, same as body copy. Put a width class on the host (for example class="max-w-3xl") if the surrounding layout does not already constrain it — extra-class only accepts spacing utilities.

Keep the quote itself short — one focused statement, not a passage

A blockquote is meant to highlight a single, punchy point, not carry an extended argument. If the source material runs long, quote the strongest sentence and summarise the rest in your own words outside the blockquote.

Do not use a blockquote for visual emphasis

It is semantic markup for quoted material, not a text-styling shortcut. To highlight your own words, use a Callout; to make text larger without implying a quotation, use Text with a size token.

Do not put interactive controls inside the quote

A link within quoted text is acceptable; a button is not. Buttons turn quoted content into a control surface, which is confusing for assistive technology.

API reference

The following are the properties and references of a blockquote

aegov-blockquote default properties

AttributeDescriptionTypeDefault

appearance

The blockquote appearance style. coloured is accepted as an alias for colored.

primary | colored | coloured

primary

cite

The citation source (a URL). Maps to the native cite attribute — not visible to sighted users.

string

undefined

author

The author or source of the quote.

string

undefined

author-title

The author's title, role, or position.

string

undefined

extra-class

Additional CSS classes merged onto the inner <blockquote> element. Only margin/padding utilities take effect (see the note below).

string

undefined

This component renders inside a real shadow DOM, so extra-class only applies margin/padding (spacing) utilities — e.g. mt-4, md:px-6. Colour, border, width, typography, and every other visual utility are silently ignored, keeping it visually consistent wherever it's used. The inner element is exposed as a CSS part, ::part(blockquote), for the rare case where a deliberate style override is genuinely needed.

Slots

SlotDescription

(default)

The quoted text to render inside the blockquote.

Pass-through attributes

AttributeNotesForwards to

aria-*, data-*

Forwarded automatically.

inner <blockquote>

lang and dir are not forwarded by the component code above — there is no explicit pass-through for them. They still work when set on <aegov-blockquote> because both are inherited across the shadow boundary like any other HTML element (the same mechanism that lets a page-level dir="rtl" flip the reading direction and text alignment automatically). Set them directly on the host only when a single quote is in a different language from the rest of the page — otherwise the page's own lang/dir already applies.

Notes

The following notes are applicable of this component.

Built-in accessibility

  • The rendered element is a real <blockquote>, so the quotation is conveyed structurally, not only visually — screen readers can announce the boundaries of quoted content.
  • cite maps to the native cite attribute, keeping the source machine-readable. It is not visible to sighted users; browsers do not render it.
  • The decorative quotation-mark icon is aria-hidden="true", so it is never announced as content — its visual orientation (see the note under RTL support) has no bearing on accessibility either way.
  • Attribution (author/authorTitle) renders inside the quote block in a fixed position, so it is never separated from the quotation it belongs to.

Developer responsibility

The following is required for a developer to add additionally or pay attention to regarding this component.

  • Attribute your quotes where practical. Set author (and authorTitle where the role adds weight) — an unattributed quotation reads as an unsourced claim, especially in a government context.
  • cite is invisible to sighted users. Add a visible link after the quote as well if the reader should be able to reach the source.
  • Keep quotations to a comfortable reading width, roughly 60–100 characters per line — a full-width pull quote is harder to read than the body copy around it. Put a width class on the host (for example class="max-w-3xl") if the surrounding layout does not already constrain it — extra-class only accepts spacing utilities, so width classes there have no effect.
  • Do not use a blockquote purely for visual emphasis. It is semantic markup for quoted material — to highlight your own text use a Callout, and to make text larger without implying a quotation use Text with a size token.
  • Mark a quote that is in a different language from the rest of the page with lang and dir on the host, so assistive technology switches pronunciation correctly (WCAG 2.2 SC 3.1.2).
  • Check contrast when using appearance="colored" — the tinted background sits behind the text, and the 4.5:1 minimum of WCAG 2.2 SC 1.4.3 still applies.
  • Restore contrast in dark mode yourself. Colours inside the shadow root are fixed light-mode colours and do not follow a page-level .dark class; override them with ::part(blockquote) and style slotted <p> elements directly. The author and title lines cannot be restyled.
  • Avoid putting interactive content inside the quote. A link within quoted text is fine; a button is not — it turns quoted content into a control surface.

Additional notes

  • Quote accuracy (using an ellipsis for omissions, etc.) is an editorial responsibility, not something the component enforces.