Collapse

Simple toggle to show or hide a single content block

Component Status

Figma

Not available

Status

Stable

HTML

Up to date

React

Up to date

Design Usage

The Collapse component shows and hides a single block of content with a toggle control. Unlike Accordion, Collapse isn’t meant for structured lists of related sections – it’s best for progressively revealing one piece of content inline, such as a long description or advanced settings.


When to Use

  • To progressively disclose additional content within a page or section (e.g., “Show more details”, “Advanced options”).
  • When space is limited and secondary information can be hidden by default.
  • For standalone toggle content that doesn’t belong to a group of expandable panels.
  • When you want to keep the interaction simple (one trigger, one panel).

When Not to Use

  • When you have multiple related sections – use Accordion.
  • For critical instructions or mandatory information – display inline instead of hiding.
  • For navigation between views or categories – use Tabs or Segmented Control.
  • For modal or blocking information – use a Modal.
  • For step-by-step tasks – use a Progress Indicator.

Best Practices

  • Use a clear, action-oriented label for the trigger (e.g., “Show more”, “Hide advanced settings”).
  • Indicate state visually and textually (label changes between “Show” / “Hide” or with an icon).
  • Place Collapse close to the content it controls to maintain clarity.
  • Avoid deeply nested Collapse inside Accordions or other Collapses — it complicates scanning.
  • Use for secondary content; don’t hide key tasks or primary information.