A section of common questions and short answers, grouped by topic, so people can find an answer
without contacting the office.
Updated
Live example
FAQ
Frequently asked questions
Answers to common questions about our services.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
FAQ
<sectionclass="nds-faq"aria-labelledby="faq-title-with-tabs"><divclass="nds-faq__intro"><h2class="nds-faq__title"id="faq-title-with-tabs"> Frequently asked questions</h2><pclass="nds-faq__body"> Answers to common questions about our services.</p></div><divclass="nds-faq__main"><divclass="nds-tabs nds-tabs--enhanced"><divclass="nds-tabs__bar"><divclass="nds-tabs__list"role="tablist"aria-label="FAQ topics"><buttontype="button"class="nds-tabs__tab"role="tab"id="faq-demo-tab-1"aria-selected="true"aria-controls="faq-demo-panel-1"tabindex="0"> General</button><buttontype="button"class="nds-tabs__tab"role="tab"id="faq-demo-tab-2"aria-selected="false"aria-controls="faq-demo-panel-2"tabindex="-1"> IT Project Clearance</button><buttontype="button"class="nds-tabs__tab"role="tab"id="faq-demo-tab-3"aria-selected="false"aria-controls="faq-demo-panel-3"tabindex="-1"> IICP Registration</button><buttontype="button"class="nds-tabs__tab"role="tab"id="faq-demo-tab-4"aria-selected="false"aria-controls="faq-demo-panel-4"tabindex="-1"> Scholarship</button></div></div><divclass="nds-tabs__panel"role="tabpanel"id="faq-demo-panel-1"aria-labelledby="faq-demo-tab-1"tabindex="0"><divclass="nds-accordion-group"><divclass="nds-accordion"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-q1-trigger"aria-expanded="false"aria-controls="faq-demo-q1-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-plus-small"></use></svg></span></button></h3><divid="faq-demo-q1-panel"class="nds-accordion__panel" hidden><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div><divclass="nds-accordion nds-accordion--open"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-q2-trigger"aria-expanded="true"aria-controls="faq-demo-q2-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-minus-small"></use></svg></span></button></h3><divid="faq-demo-q2-panel"class="nds-accordion__panel"><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div><divclass="nds-accordion nds-accordion--open"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-q3-trigger"aria-expanded="true"aria-controls="faq-demo-q3-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-minus-small"></use></svg></span></button></h3><divid="faq-demo-q3-panel"class="nds-accordion__panel"><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div><divclass="nds-accordion"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-q4-trigger"aria-expanded="false"aria-controls="faq-demo-q4-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-plus-small"></use></svg></span></button></h3><divid="faq-demo-q4-panel"class="nds-accordion__panel" hidden><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div></div></div><divclass="nds-tabs__panel"role="tabpanel"id="faq-demo-panel-2"aria-labelledby="faq-demo-tab-2"tabindex="0" hidden><divclass="nds-accordion-group"><divclass="nds-accordion"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-it-q1-trigger"aria-expanded="false"aria-controls="faq-demo-it-q1-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-plus-small"></use></svg></span></button></h3><divid="faq-demo-it-q1-panel"class="nds-accordion__panel" hidden><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div></div></div><divclass="nds-tabs__panel"role="tabpanel"id="faq-demo-panel-3"aria-labelledby="faq-demo-tab-3"tabindex="0" hidden><divclass="nds-accordion-group"><divclass="nds-accordion"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-iicp-q1-trigger"aria-expanded="false"aria-controls="faq-demo-iicp-q1-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-plus-small"></use></svg></span></button></h3><divid="faq-demo-iicp-q1-panel"class="nds-accordion__panel" hidden><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div></div></div><divclass="nds-tabs__panel"role="tabpanel"id="faq-demo-panel-4"aria-labelledby="faq-demo-tab-4"tabindex="0" hidden><divclass="nds-accordion-group"><divclass="nds-accordion"><h3class="nds-accordion__heading"><buttontype="button"class="nds-accordion__trigger"id="faq-demo-sch-q1-trigger"aria-expanded="false"aria-controls="faq-demo-sch-q1-panel"><spanclass="nds-accordion__title"> Placeholder title text here</span><spanclass="nds-accordion__icon-wrap"aria-hidden="true"><svgclass="nds-accordion__icon"width="20"height="20"focusable="false"aria-hidden="true"><usehref="#nds-icon-plus-small"></use></svg></span></button></h3><divid="faq-demo-sch-q1-panel"class="nds-accordion__panel" hidden><divclass="nds-accordion__content"> Placeholder content here. Add anything you’d like the user to reveal when this section expands.</div></div></div></div></div></div></div></section>
Overview
Use an FAQ section for questions people really ask, from calls, emails and searches. Group them by
topic, keep each answer short, and link to the full guidance.
Use an FAQ section for
Questions people ask the office again and again
A service or programme page, after the main content
Short answers, with a link to more detail
Don’t use an FAQ section for
Information people need before they start (put it on the page)
Long guidance (write a page for it)
Questions nobody asks
Variants
One pattern for desktop and mobile. Topic tabs are optional.
Frequently asked questions
Answers to common questions about our services.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Desktop, with tabs
Title at the top, then topic tabs, then questions.
Frequently asked questions
Answers to common questions about our services.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Desktop, without tabs
For a short list of questions on one topic.
Frequently asked questions
Answers to common questions about our services.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Mobile
The heading sits above the questions. Tabs scroll sideways if they don’t fit.
Specifications
The properties of nds-faq. The same in HTML, WordPress and React.
FAQ properties
Property
Type
Possible values
Description
title
string
Frequently asked questions default
The section heading.
body
string
Answers to common questions about our services.
A short intro under the heading.
showTabs
boolean
true default
false
Topic tabs. Turn off for a short list on one topic.
items
array
{ question, answer, topic }
Each question becomes an accordion item.
In code, each question is an Accordion item: a <button aria-expanded> inside a
heading, with the answer in a region below. Topic tabs use the Tabs component.
Tokens
FAQ tokens and contrast
Part
Token
Contrast on the page
Questions
Accordion component
—
Topic tabs
Tabs component
—
Heading and intro
text/primary, text/secondary
17.6:1 · 6.6:1
Answers
text/primary, Body/medium
17.6:1
Use cases
Do
Frequently asked questions
Answers to common questions about our services.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Group questions by topic, and write them the way people ask them.
Don’t
Frequently asked questions
Answers to common questions about our services.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Placeholder content here. Add anything you’d like the user to reveal when this section expands.
Don’t open every answer by default. Let people open the ones they need.
Layout
Where the FAQ section sits and how it’s arranged.
After the main content
Near the end of a service or programme page, before contact details.
Title at the top
Title and intro sit above the questions on every screen. Topic tabs (optional) sit between them.
About 4 to 8 questions
For more, group them by topic with tabs.
Copywriting
How to write questions and answers.
Ask in people’s own words
“How long does a passport take?”, not “Processing times”.
Answer in the first sentence
Then add detail or a link.
Link to the full guidance
An FAQ is a shortcut, not the only place the answer lives.
Examples
FAQ copywriting examples
Write
Don’t write
Why
How long does a passport take?
Processing timelines
Uses people’s own words.
It takes about 6 weeks.
Processing times vary depending on several factors.
Answers first.
Read how to renew a passport
Click here
Says where the link goes.
Accessibility
Each question is an accordion button inside a heading, so screen readers can list the questions and
open them one by one.
Keyboard interaction for FAQ
Key
What it does
Tab
Moves between questions and tabs.
Enter / Space
Opens or closes the answer.
← →
Moves between topic tabs.
Questions are buttons inside headings, in page order (WCAG 1.3.1, 2.4.6).
Open or closed is announced with aria-expanded (WCAG 4.1.2).
The plus and minus icons are not the only sign: the answer shows or hides (WCAG 1.4.1).
Tabs follow the Tabs component, with arrow-key movement (WCAG 2.1.1).
For developers
Copy the code for HTML, WordPress or React from the Code tab in Live example. The options are listed
under Specifications.