# List

Semantic `<ul>`/`<ol>` container. Children must be `ListItem`. Use this over raw HTML lists in Text when you need consistent markers (check, bullet, dash, icon).

## Key files

- [packages/sdk/src/components/List.tsx](../../../packages/sdk/src/components/List.tsx)
- [packages/sdk/src/components/List.craft.tsx](../../../packages/sdk/src/components/List.craft.tsx)
- [lib/schemas/List.json](../../../lib/schemas/List.json)

## Props

| Prop                | Notes                                                                                                                     |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| `ordered`           | When true, renders `<ol>` with native numbering.                                                                          |
| `markerStyle`       | `"bullet"` \| `"check"` (default) \| `"dash"` \| `"icon"`. Ignored when `ordered: true`.                                  |
| `markerIcon`        | When `markerStyle: "icon"`: `{ value, size }` — `value` is `ref-icon:<set>/<ExportName>` (default `ref-icon:tb/TbCheck`). |
| `className`, `root` | Standard.                                                                                                                 |

Children: `ListItem` only.

## When to use

- Feature bullets, pricing rows, checklists.
- For free-form text with paragraphs and bold/italic, use [Text](text.md) with raw `<ul>`/`<ol>` HTML inside (but you lose marker consistency).

## Related

- [ListItem](list-item.md), [Text](text.md)


Semantic <ul/<ol container. Children must be ListItem. Use this over raw HTML lists in Text when you need consistent markers (check, bullet, dash, icon).

Prop	Notes
`ordered`	When true, renders `<ol>` with native numbering.
`markerStyle`	`"bullet"` \| `"check"` (default) \| `"dash"` \| `"icon"`. Ignored when `ordered: true`.
`markerIcon`	When `markerStyle: "icon"`: `{ value, size }` — `value` is `ref-icon:<set>/<ExportName>` (default `ref-icon:tb/TbCheck`).
`className`, `root`	Standard.