Accordions are a vertical list of interactive headers. Users open them to reveal content or close them to hide content.
How they function
They’re closed by default. This collapses the page, making it easier for users to scroll.
Users can open one accordion or several at a time.
When to use them
There are only a few cases when you should use accordions. Either you have Frequently Asked Questions (FAQs) or you want to group two to seven related topics.
In these cases, accordions help users scan the page and find what they want.
When not to use them
Research shows that misused accordions can harm usability. So, do not use them for:
- Short pages
- Timely or actionable content
- Step-by-step instructions (use the process list instead)
- Complex, interactive elements like forms
- Layouts with two or more columns
- Images, charts, tables, videos, and other media
Follow these rules
Headings
- Keep them to 160 characters or fewer.
- Make them short, clear, and descriptive.
- Select the correct level based on page location (H2, H3, H4, or DIV).
Content and functionality
- Use no more than three short paragraphs in each accordion.
- Link directly to an accordion from another page (each has a unique ID).
Type
- Use multi-select to show and compare information within different accordions.
- Choose single-select when users do not need to open two or more accordions at once.
Examples
Single-select accordions
Allows users to open and close one accordion at a time.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec elementum tellus nec lectus condimentum ullamcorper et vitae ex. Pellentesque et nulla eget turpis ullamcorper condimentum et ac arcu.
Donec sed magna dolor. Donec convallis turpis risus, eu bibendum diam congue eget. In hac habitasse platea dictumst. Mauris elementum luctus auctor.
Donec in sagittis ante. Sed consequat risus ut lacinia auctor. Nulla ac ornare purus, vel sodales leo. Sed hendrerit non diam quis pulvinar.
Multi-select accordions
Allows users to open and close more than one accordion at a time.
Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec elementum tellus nec lectus condimentum ullamcorper et vitae ex. Pellentesque et nulla eget turpis ullamcorper condimentum et ac arcu.
Donec sed magna dolor. Donec convallis turpis risus, eu bibendum diam congue eget. In hac habitasse platea dictumst. Mauris elementum luctus auctor.
Donec in sagittis ante. Sed consequat risus ut lacinia auctor. Nulla ac ornare purus, vel sodales leo. Sed hendrerit non diam quis pulvinar.