FormsReact Native

Settings row

Align a setting title and explanation with an optional graphic and trailing native control.

Public APILumenSettingsRowReact Native

Native example

Use Settings row

Use to align repeated settings rows. The trailing content should be a compact native control rather than unrelated actions.

View verified React Native runtime capture

Settings row rendered in the Expo web renderer Lumen playground — Verified runtime captureExpo web renderer

<LumenSettingsRow
  title="Automatic updates"
  description="Download stable updates automatically."
  control={
    <LumenToggle
      label="Automatic updates"
      value={automaticUpdates}
      showLabel={false}
      onValueChange={setAutomaticUpdates}
    />
  }
/>

Reference

Public API

The primary shared and platform-specific options exposed by LumenSettingsRow.

API	Values or type	Default	Description
title	`string`	`Required`	Names the setting.
description	`string`	`undefined`	Adds supporting explanation.
graphic	`ReactNode`	`undefined`	Adds an optional leading graphic.
control	`ReactNode`	`Required`	Provides the trailing native control.

Native behavior

Design and accessibility

When to use it

Use to align repeated settings rows. The trailing content should be a compact native control rather than unrelated actions.

Accessibility

The explanatory copy and trailing control remain contained while the control preserves independent focus and semantics.

Shared component

Available on other platforms

Apple / SwiftUI Android / Compose