FeedbackReact Native

Error state

Explain an unavailable region or page and offer application-owned recovery.

Public APILumenErrorStateReact Native

Native example

Use Error state

Use when a region or page cannot show its primary content. Keep retry and request policy in application state; use Banner when existing content remains useful.

View verified React Native runtime capture

Error state rendered in the Expo web renderer Lumen playground — Verified runtime captureExpo web renderer

<LumenErrorState
  kind="offline"
  title="Could not load projects"
  description="Check your connection and try again."
  reference="REQ-4F82"
  actions={<LumenButton onPress={retry}>Try again</LumenButton>}
/>

Reference

Public API

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

API	Values or type	Default	Description
title	`string`	`Required`	Names the unavailable content or failed operation.
kind	`error \| offline`	`error`	Selects error or offline context and its default illustration.
layout	`compact \| default \| page`	`default`	Adapts spacing and whether the state fills its available page height.
reference	`string`	`undefined`	Shows a safe support reference without exposing technical details.
actions	`ReactNode`	`undefined`	Provides application-owned recovery actions.

Native behavior

Design and accessibility

When to use it

Use when a region or page cannot show its primary content. Keep retry and request policy in application state; use Banner when existing content remains useful.

Accessibility

The title is a heading, recovery actions retain native focus order, and React Native and Compose expose configurable live-region behavior.

Shared component

Available on other platforms

Apple / SwiftUI Android / Compose