## Usage `` is a lightweight inline disclosure — a small chevron + title that toggles a child block in and out. Use it for nested API parameters, advanced options, or any "details on demand" content that would clutter the page if shown inline. ```mdx Number of times to retry failed requests. Milliseconds to wait between retries. ``` Number of times to retry failed requests. Milliseconds to wait between retries. ## Nested API parameters The most common use case: documenting an `object`-typed parameter and disclosing its properties on demand. ```mdx The user object passed to the request body. Unique identifier — must be prefixed with `usr_`. Valid email address. Role assigned to the user. ``` The user object passed to the request body. Unique identifier — must be prefixed with `usr_`. Valid email address. Role assigned to the user. ## Default open Pre-open the disclosure with `defaultOpen` if the content is important enough that you want most readers to see it without clicking: ```mdx ```json { "id": "abc123", "status": "ok" } ``` ``` ## Nesting Expandables can nest inside each other for deeply hierarchical data: ```mdx Primary color. Max content width in pixels. ``` The left border indents each level visually so readers can track depth. ## Differences from `` | | `` | `` | |---|---|---| | **Visual weight** | Light — small chevron + text | Heavy — full bordered card | | **Grouping** | Single instance, no value pairing | Multiple items with shared open state | | **Designed for** | Inline nested content | FAQs, standalone disclosure groups | | **Composition** | Nests inside ParamField, etc. | Top-level page section | If you have a list of independent FAQ items, use [``](/components/accordion). If you have one nested object in an API parameter, use ``. ## Props | Prop | Type | Default | Description | |------|------|---------|-------------| | `title` | `string` | required | Disclosure title shown next to the chevron | | `defaultOpen` | `boolean` | `false` | Whether the content is visible on first render | | `children` | `ReactNode` | required | Disclosure body |