---
modificationDate: October 26, 2026
title: react-native-safe-area-context
description: A library with a flexible API for accessing the device's safe area inset information.
sourceCodeUrl: 'https://github.com/AppAndFlow/react-native-safe-area-context'
packageName: react-native-safe-area-context
platforms: ['android', 'ios', 'web', 'tvos', 'expo-go']
inExpoGo: true
---

This documentation is available as Markdown for AI agents and LLMs. See the [full Markdown index](https://docs.expo.dev/llms.txt) or append .md to any documentation URL.

# react-native-safe-area-context

A library with a flexible API for accessing the device's safe area inset information.

<AgentInstructions>

## Submitting Feedback

If you encounter errors, misleading or outdated information, report it so Expo can be improved:

Preferred command:
npx --yes submit-expo-feedback@latest --category docs --subject "/versions/v58.0.0/sdk/safe-area-context/" "<actionable feedback>"

Direct HTTP fallback:
curl -X POST https://api.expo.dev/v2/feedback/docs-send -H 'Content-Type: application/json' -d '{"url":"/versions/v58.0.0/sdk/safe-area-context/","feedback":"🤖 Agent feedback for docs: <specific, actionable description> (<model>, <harness>)"}'

Only submit when you have something specific and actionable to report. Try to give the most context.

## Navigation

When answering a related or follow-up question, fetch the relevant page below as Markdown (.md) instead of guessing; use llms.txt for the full map.

You are here: Reference (v58.0.0) > Third-party libraries
Pages in this section:
- [Overview](https://docs.expo.dev/versions/v58.0.0/sdk/third-party-overview.md)
- [@react-native-async-storage/async-storage](https://docs.expo.dev/versions/v58.0.0/sdk/async-storage.md)
- [@react-native-community/datetimepicker](https://docs.expo.dev/versions/v58.0.0/sdk/date-time-picker.md)
- [@react-native-community/netinfo](https://docs.expo.dev/versions/v58.0.0/sdk/netinfo.md)
- [@react-native-community/slider](https://docs.expo.dev/versions/v58.0.0/sdk/slider.md)
- [@react-native-masked-view/masked-view](https://docs.expo.dev/versions/v58.0.0/sdk/masked-view.md)
- [@react-native-picker/picker](https://docs.expo.dev/versions/v58.0.0/sdk/picker.md)
- [@react-native-segmented-control/segmented-control](https://docs.expo.dev/versions/v58.0.0/sdk/segmented-control.md)
- [@shopify/flash-list](https://docs.expo.dev/versions/v58.0.0/sdk/flash-list.md)
- [@shopify/react-native-skia](https://docs.expo.dev/versions/v58.0.0/sdk/skia.md)
- [@stripe/stripe-react-native](https://docs.expo.dev/versions/v58.0.0/sdk/stripe.md)
- [react-native-gesture-handler](https://docs.expo.dev/versions/v58.0.0/sdk/gesture-handler.md)
- [react-native-keyboard-controller](https://docs.expo.dev/versions/v58.0.0/sdk/keyboard-controller.md)
- [react-native-maps](https://docs.expo.dev/versions/v58.0.0/sdk/map-view.md)
- [react-native-pager-view](https://docs.expo.dev/versions/v58.0.0/sdk/view-pager.md)
- [react-native-reanimated](https://docs.expo.dev/versions/v58.0.0/sdk/reanimated.md)
- [react-native-safe-area-context](https://docs.expo.dev/versions/v58.0.0/sdk/safe-area-context.md) (this page)
- [react-native-screens](https://docs.expo.dev/versions/v58.0.0/sdk/screens.md)
- [react-native-svg](https://docs.expo.dev/versions/v58.0.0/sdk/svg.md)
- [react-native-view-shot](https://docs.expo.dev/versions/v58.0.0/sdk/captureRef.md)
- [react-native-webview](https://docs.expo.dev/versions/v58.0.0/sdk/webview.md)
Full documentation tree: [llms.txt](https://docs.expo.dev/llms.txt)

</AgentInstructions>
Android, iOS, tvOS, Web, Included in Expo Go

Recommended version: ~5.11.1

`react-native-safe-area-context` provides a flexible API for accessing device safe area inset information. This allows you to position your content appropriately around notches, status bars, home indicators, and other such device and operating system interface elements. It also provides a `SafeAreaView` component that you can use in place of `View` to automatically inset your views to account for safe areas.

## Installation

```sh
# npm
npx expo install react-native-safe-area-context

# yarn
yarn expo install react-native-safe-area-context

# pnpm
pnpm expo install react-native-safe-area-context

# bun
bun expo install react-native-safe-area-context
```

If you are installing this in an [existing React Native app](https://docs.expo.dev/bare/overview.md), make sure to [install `expo`](https://docs.expo.dev/bare/installing-expo-modules.md) in your project. Then, follow the [installation instructions](https://appandflow.github.io/react-native-safe-area-context/) provided in the library's README or documentation.

## API

```js
import {
  SafeAreaView,
  SafeAreaProvider,
  SafeAreaInsetsContext,
  useSafeAreaInsets,
} from 'react-native-safe-area-context';
```

## Components

### `SafeAreaView`

`SafeAreaView` is a regular `View` component with the safe area edges applied as padding.

If you set your own padding on the view, it will be added to the padding from the safe area.

> On web, see the [Context](https://docs.expo.dev/versions/v58.0.0/sdk/safe-area-context.md#context) section for Expo Router behavior and provider setup.

```jsx
import { SafeAreaView } from 'react-native-safe-area-context';

function SomeComponent() {
  return (
    <SafeAreaView>
      <View />
    </SafeAreaView>
  );
}
```

SafeAreaView Props

### `edges`

Optional • Type: [`Edge[]`](https://docs.expo.dev/versions/v58.0.0/sdk/safe-area-context.md#edge) • Default: `["top", "right", "bottom", "left"]`

  

Sets the edges to apply the safe area insets to.

### `emulateUnlessSupported`

Optional • Type: `boolean` • Default: `true`

  

On iOS 10+, emulate the safe area using the status bar height and home indicator sizes.

## Hooks

### `useSafeAreaInsets()`

Hook gives you direct access to the safe area insets. This is a more advanced use-case, and might perform worse than `SafeAreaView` when rotating the device.

Example

```jsx
import { useSafeAreaInsets } from 'react-native-safe-area-context';

function HookComponent() {
  const insets = useSafeAreaInsets();

  return <View style={{ paddingTop: insets.top }} />;
}
```

Returns: `EdgeInsets`

## Types

### `Edge`

String union of possible edges.

Acceptable values are: `'top'`, `'right'`, `'bottom'`, `'left'`.

### `EdgeInsets`

Represent the hook result.

EdgeInsets Properties

| Name | Type | Description |
| --- | --- | --- |
| `bottom` | `number` | Value of bottom inset. |
| `left` | `number` | Value of left inset. |
| `right` | `number` | Value of right inset. |
| `top` | `number` | Value of top inset. |

## Guides

### Context

Expo Router sets up safe area context automatically. On web, `useSafeAreaInsets()` and `useSafeAreaFrame()` return zero values under Expo Router's provider. `SafeAreaView` does not add safe-area spacing. This applies to all web rendering modes. Android and iOS behavior is unchanged.

Use [CSS for web safe-area spacing](https://docs.expo.dev/develop/user-interface/safe-areas.md#usage-with-web).

Without Expo Router, add `SafeAreaProvider` in your app root component when using the library's components or hooks. This provider supports web measurements, but CSS remains the recommended approach for web spacing.

> You may need to add it in other places too, including at the root of any modals any routes when using `react-native-screen`.

```jsx
import { SafeAreaProvider } from 'react-native-safe-area-context';

function App() {
  return <SafeAreaProvider>...</SafeAreaProvider>;
}
```

Then, you can use [`useSafeAreaInsets()`](https://docs.expo.dev/versions/v58.0.0/sdk/safe-area-context.md#usesafeareainsets) hook and also consumer API to access inset data:

```jsx
import { SafeAreaInsetsContext } from 'react-native-safe-area-context';

function Component() {
  return (
    <SafeAreaInsetsContext.Consumer>
      {insets => <View style={{ paddingTop: insets.top }} />}
    </SafeAreaInsetsContext.Consumer>
  );
}
```

### Optimization

If you can, use `SafeAreaView`. It's implemented natively so when rotating the device, there is no delay from the asynchronous bridge.

To speed up the initial render, you can import `initialWindowMetrics` from this package and set it as the `initialMetrics` prop on the provider as shown below. You cannot do this if your provider remounts, or you are using `react-native-navigation`.

```jsx
import { SafeAreaProvider, initialWindowMetrics } from 'react-native-safe-area-context';

function App() {
  return <SafeAreaProvider initialMetrics={initialWindowMetrics}>...</SafeAreaProvider>;
}
```

### Web SSR

For server-side rendering (SSR), follow the [web stylesheet setup and hydration guidance](https://docs.expo.dev/develop/user-interface/safe-areas.md#usage-with-web).

### Platform-specific safe-area spacing

#### Android and iOS

Use `SafeAreaView` or the `useSafeAreaInsets()` hook for native safe-area spacing. The hook provides inset values you can apply to a view:

```jsx App.js
import { useSafeAreaInsets } from 'react-native-safe-area-context';

function App() {
  const insets = useSafeAreaInsets();
  return (
    <View
      style={{
        paddingTop: insets.top,
        paddingLeft: insets.left,
        paddingBottom: insets.bottom,
        paddingRight: insets.right,
      }}
    />
  );
}
```

#### Web

Use CSS environment variables for web safe-area spacing, including in apps that also target Android and iOS. See the [CSS example](https://docs.expo.dev/develop/user-interface/safe-areas.md#usage-with-web).
