Accordion Item

tile/accordionItem

Creates an expandable section within an accordion. Each section has a clickable header with a title and optional icon.

NameRequiredLightning TypeDefaultDescription
iconAltNolightning__textTypeAlternative text describing what the header icon conveys. When omitted or empty, the icon is treated as decorative and hidden from assistive technologies.
iconNameNolightning__iconNameAn icon identifier shown in the section header next to the title.
isExpandedNolightning__booleanTypefalseSpecifies whether this section is currently expanded to show its content.
subtitleNolightning__textTypeSecondary text shown beneath the title in the accordion section header.
titleYeslightning__textTypeThe header text for the clickable trigger on the accordion section.

Use an accordion item to define a section within a tile/accordion. Each item renders a clickable header with its title, optional subtitle, and optional iconName, and reveals its child content when expanded. Accordion items are only valid as direct children of a tile/accordion.

Add a subtitle to show secondary text under the title, useful for a short preview of the section’s content.

To draw a section open on first render, set isExpanded to true.

To stack multiple pieces of content in one section, wrap them in a tile/column, and mix in components like tile/badge or tile/button for richer sections.

Consider these guidelines when working with accordion items.

  • Keep each title concise and descriptive so users can scan headers and find the right section quickly.
  • Use subtitle for a short, scannable preview of a section’s content so users can decide whether to expand it without guessing from the title alone.
  • To highlight the most important section, set isExpanded on it rather than leaving every section collapsed.
  • Do not depend on whether opening one section collapses the others — each surface decides that expansion behavior, so use isExpanded only to seed the initial state.
  • Add an iconName when a visual cue helps users recognize the section immediately, but omit it when titles are already clear.

Note any limitations that apply to this component.

No known limitations for tile/accordionItem in Slackbot.

No known limitations for tile/accordionItem in ChatGPT.

No known limitations for tile/accordionItem in Agentforce.