Accordion

An accordion is a stack of headers, each opening a panel of content in place, so a page can list many topics and show only what a reader asks for. Orvain's Accordion family runs to seven: a searchable help page with counted topic tags and a vote per answer, a settings panel of folding sections, and five item shapes, boxed rows for narrow columns, a numbered column for ordered steps, a header card over a body card, a badged row holding a value worth copying, and a minimal item that is only a question until it opens.

The decision readers notice most is whether opening one item closes the rest. Closing them makes two answers impossible to compare, and comparison is exactly why somebody is reading a pricing FAQ, so allow several open unless the items are steps that only make sense one at a time. Scroll is the other thing to get right: opening a panel pushes everything below it down the page, and a reader who clicked one question can end up staring at a different one.

11 blocks

FAQ page

Knowledge bases and help centres: search, topics and answers on one page

FAQ chapters

Long help centres: topics as chapters of one page, with a rail that follows you

Settings sections

Account and workspace panels: grouped settings that fold away

Settings draft

Workspace settings that affect everyone: nothing applies until you save

Bordered items

Sidebars and narrow columns: a boxed row per question

Numbered items

Onboarding and setup guides: ordered steps that open in place

Split cards

Docs and changelogs: each step reads as its own card

Badge items

Account settings: a status per row and a value worth copying

Minimal items

Long-form pages: questions with nothing around them but the answer

Accordion part

Settings, help and docs lists where what is open should stand out

Accordion rail

Step-by-step guides and lists that should read as a sequence

01

Using Accordion

Reach for it when

  • A page of independent questions where each reader has come for exactly one of them.
  • Settings grouped into sections, worked on one section at a time.
  • An ordered guide whose steps stay visible as a list while one of them is being read.
  • Reference rows that are mostly a value, where only some of them need explaining.

Reach for something else when

  • Anything every reader has to read. Folded content is content most people skip: put it on the page.
  • Switching between views of the same object. Tabs keep one panel open by design and do not shove the page around.
  • Three short paragraphs. The chevron costs a reader more attention than the text it is hiding.
02

Where it shows up

01

Pricing FAQ

The block under a pricing table answering what the table cannot: billing cycles, changing seat counts, what happens when a trial ends. Several open at once, because people are comparing two answers.

02

Help centre

A topic page where search narrows the list and each tag says how many articles sit under it. Answers open beneath their question rather than on a new page, so the result list stays on screen.

03

Account settings

Profile, billing and notification sections stacked in one panel, each folding shut once it is done with. A row can hold a switch, or a key with a copy button, without leaving the section.

04

Setup guide

Numbered steps for connecting a service, opened one at a time. The numbers survive folding, so somebody who stops halfway can still see how much of it is left.

03

Questions

Should more than one accordion panel be open at once?

Default to allowing it. Readers open a second item to compare it with the first, and closing the first makes that impossible. Restrict the accordion to one panel at a time only when the content is sequential, such as a setup wizard or a form split into stages, where two steps open together would suggest they can be done in either order.

Are accordions bad for search engines?

All blocks
The Orvain Dispatch

Premium components, free in your inbox.

Join the Orvain Dispatch and get production-ready components, free to keep: React and Vue code plus the Figma frame, yours to ship.

Just components, never spam. You can unsubscribe anytime.