Expand or collapse part of a form

Use accordions to organize form review sections that users can expand or collapse.

When to use

Use this pattern when:

  • Presenting a review summary of form sections before submission
  • Users need to verify information across multiple categories
  • Sections contain detailed information that may not need constant visibility
  • You want to highlight sections that have been updated

Considerations

  • Use headingContent to add badges or status indicators to section headers
  • Use definition lists (<dl>) for structured label/value pairs
  • Apply consistent spacing with CSS custom properties
  • Consider defaulting important or recently updated sections to expanded state
View old example docs