Accordion
A header that opens to show a section of content. It comes in three sets: the Normal Accordion in five types, a pill that opens into a card, and a quiet row with a red rail down its panel.
Insert the accordion description here. It would look better as two lines of text.
Add a closed Orvain Accordion (1.0, type 01) titled “Insert your accordion title here”, with an info icon and a plus toggle.
When to use#
- For FAQs, settings groups and long forms, where most people need only one or two sections.
- When the headers give enough information to choose which one to open.
- In narrow spaces, such as a sidebar or phone, where tabs do not fit side by side.
When not to use
- Show content everyone needs directly on the page. Hiding it adds a click.
- Use a Tab Menu Horizontal to switch between peer views of one thing.
Anatomy#
Satoshi Medium 16 (18 in the 2.0 and 3.0 sets), with an optional info glyph or a count before it.
Plus and minus, or a chevron that points down then up; 20px, or 24px in types [03] and [04].
[01] and [02]: 440 wide, 16px in, radius 12. [03] to [05]: 626 wide. [05] adds a badge and a 32px pill for the toggle.
Text, or in [05] a paragraph and a link field with a copy button; it opens with a short height animation.
2.0: a 60px pill (grey or brand) that opens into a card with a description, a link and a 48px close button. 3.0: the panel sits behind a 2px red rail.
States#
Closed; the toggle in #8f8f8f.
The card takes an 8% wash (12% in [02]); the toggle darkens.
The focus ring around the card, on keyboard focus only.
Open: the panel shows and the toggle turns to minus or points up.
The header can't be toggled; the card turns #fcfcfc.
2.0 and 3.0: shown open, with no toggle.
2.0: a blue pill, and a soft lift with a highlight.
Source#
The Accordion ships in the free packages, @orvain/react and @orvain/vue, and in the Figma library with every variant and state shown above. The code on this page is the code you install.
Used in these blocks

