Accordion Documentation


The Accordion component is a versatile UI element that allows users to expand and collapse content sections. It is commonly used to organize and present information in a compact and easy-to-navigate format. This documentation provides an overview of the Accordion component, including its anatomy, usage guidelines, and accessibility considerations.


The Accordion component consists of the following elements:

  1. Accordion Container: The outer container that holds the entire Accordion component.
  2. Accordion Section: Each section within the Accordion that contains a header and content.
  3. Accordion Header: The clickable element that expands or collapses the corresponding content section.
  4. Accordion Content: The content that is hidden or revealed when the Accordion header is clicked.


To use the Accordion component in your web app, follow these guidelines:

  1. Import the component: Include the necessary CSS and JavaScript files to enable the Accordion functionality.
  2. Structure your content: Divide your content into logical sections that can be expanded or collapsed.
  3. Implement the Accordion: Wrap each section of content with an Accordion Section element, and provide a unique ID for each section.
  4. Add headers and content: Within each Accordion Section, add an Accordion Header element and an Accordion Content element. Customize the header text to provide meaningful labels for each section.
  5. Handle user interactions: Implement the necessary event listeners to handle user clicks on the Accordion headers. Toggle the visibility of the corresponding content section when a header is clicked.
  6. Style the Accordion: Apply appropriate styling to ensure the Accordion component matches the overall design of your web app.

When Not to Use the Accordion

While the Accordion component offers a convenient way to organize content, it may not be suitable for every situation. Consider the following scenarios when deciding whether to use an Accordion:

  1. Limited content: If you have only a small amount of content that doesn’t require collapsing, consider using a simpler layout without the Accordion.
  2. Complex interactions: If your content requires more complex interactions, such as multiple levels of nesting or dynamic updates, an Accordion may not be the best choice. Explore other components like tabs or menus that better suit your needs.
  3. Mobile optimization: If your web app primarily targets mobile users, consider the limited screen space available. Accordion components may not provide the best user experience on smaller screens.

Accordion vs. Tabbed Interface

The Accordion component shares similarities with the Tabbed interface, but they serve different purposes. Here are the key differences:

  1. Visibility: In an Accordion, only one section can be expanded at a time, while the rest remain collapsed. In contrast, Tabbed interfaces allow multiple tabs to be open simultaneously.
  2. Content organization: Accordions are useful for organizing large amounts of content within collapsible sections, while Tabbed interfaces are better suited for presenting different views or categories of content.
  3. User interaction: Accordion headers toggle the visibility of the corresponding content section, while Tabbed interfaces switch between different content views.

Consider the nature of your content and the desired user experience when choosing between an Accordion and a Tabbed interface.

Accessibility Guidelines

To ensure the Accordion component complies with level AA of WCAG 2.2, follow these accessibility guidelines:

  1. Keyboard navigation: Enable keyboard navigation so that users can navigate and interact with the Accordion using only the keyboard.
  2. Focus management: Ensure that focus is properly managed when expanding or collapsing Accordion sections, allowing users to navigate through the content with ease.
  3. Aria roles and attributes: Use appropriate ARIA roles and attributes to provide additional context and improve accessibility for assistive technologies.
  4. Contrast and readability: Ensure sufficient contrast between the Accordion headers, content, and background to enhance readability for users with visual impairments.
  5. Responsive design: Optimize the Accordion component for different screen sizes and ensure that it remains fully functional and accessible on mobile devices.

Best Practices

Follow these best practices to make the most of the Accordion component:

  1. Clear and concise labels: Use descriptive labels for the Accordion headers to provide users with a clear understanding of the content within each section.
  2. Progressive disclosure: Consider using the Accordion to progressively disclose additional content or details, allowing users to focus on the information they need.
  3. Consistent styling: Maintain consistency in the styling of the Accordion component across your web app to provide a cohesive user experience.
  4. Testing and feedback: Test the Accordion component thoroughly across different devices and assistive technologies to ensure its functionality and accessibility. Gather user feedback to identify any areas for improvement.

By following these guidelines and best practices, you can effectively incorporate the Accordion component into your web app, providing an intuitive and accessible user interface for both designers and developers.

For more information and examples, refer to the Accordion component documentation in the GOV.UK Design System.