| Do | Wrap each XDSCollapsible in an XDSCard for visual separation in accordion layouts. |
| Do | Use XDSCollapsibleGroup with type="single" for settings or FAQ pages where only one section should be open at a time. |
| Do | Use type="multiple" when users need to compare content across sections, like feature lists or pricing tiers. |
| Do | Start sections open (defaultIsOpen) when the content is likely needed on first view — don't make users click to see essential info. |
| Don't | Hide critical or required content behind a collapsible — users may not discover it. |
| Don't | Nest collapsibles more than two levels deep — it makes content hard to find and navigate. |
| Don't | Use a collapsible for a single short paragraph — just show the text directly instead. |