# Settings lists

Canonical page: https://docs.ovok.com/native-sdk/guide/modules/setting

Use `SettingList` to render grouped settings rows with section headers and custom
items. The SDK handles the list presentation; the app owns setting values, updates,
permissions, and persistence.

```tsx
import { SettingList } from "@ovok/native/setting";

<SettingList
  data={[
    "Account",
    { title: "Language", onPress: openLanguageSettings },
    { title: "Notifications", onPress: openNotifications },
  ]}
/>
```

Wire each row to a real action and reflect the saved value after the update succeeds.
For asynchronous changes, show progress and failure feedback in the screen. Use a
custom item when the setting needs a control such as a switch; do not make the row
look interactive if it has no action.

## References [#references]

- [SettingList](/native-sdk/guide/components/setting/setting-list/)
- [SettingListItem](/native-sdk/guide/components/setting/setting-list-item/)
- [ListHeader](/native-sdk/guide/components/setting/list-header/)
- [Setting component index](/native-sdk/guide/components/setting/)

## API reference [#api-reference]

Every export of `@ovok/native/setting`, with signatures, props and types, is in the [`setting` API reference](/native-sdk/reference/setting).