Expandable section

An expandable section is a content section with a text toggle that reveals content that is hidden by default.

Elements

An expandable section has two main elements.

Elements of an expandable section.
  1. Toggle (fa-angle-right): Indicates whether the section is expanded or collapsed.
  2. Toggle text: Informs the user what will be shown when the component is expanded.

Usage

Use an expandable section when you want to hide optional or advanced content by default. They are commonly used in forms to reveal plain text or additional form fields. They can also be used to reveal charts, cards, data lists, or table views. Expandable sections can also be used in alerts to show additional information.

We recommend using dynamic toggle text for an expandable section, which will update the toggle text based on the state of the expandable section. For example, it may read Show more when the toggle is collapsed, and Show less when the toggle is open.

Variations

Expandable section disclosure

A collapsed section of content, with a "show more" link beside an expanded content section with a "show less" link and a block of text content.

Expandable section for truncated text

A paragraph of text, truncated at the end, with a link that says "show more", followed by a fully expanded paragraph of text that now has a link that says "show less".

Expandable section in a form

Example of an expandable section in a form.

Expandable section in an inline alert

Example of an expandable section in an inline alert.

Expandable section in a side panel

Example of an expandable section in a side panel.

Expandable section in a documentation page

Example of an expandable section in a documentation page.

For more information regarding accessibility, visit the expandable section accessibility tab.