This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 54).

A library that provides access to age range information using Play Age Signals API on Android and Declared Age Range framework on iOS.

expo-age-range provides access to user age range information. It uses Google's Play Age Signals API on Android and Apple's Declared Age Range framework on iOS.

This API allows you to request age range information from users to help you comply with age-appropriate content regulations (such as in Texas) and provide age-appropriate experiences in your app.

Limitations

We strongly recommend testing the functionality on a real device, as simulator runtimes may not work as expected.

On Android, the Play Age Signals API (beta) throws an exception until January 1, 2026, as per the official Android documentation. From January 1, the API will return live responses.

Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

Configuration in app config

Setup iOS project

To use the age range API on iOS, you need to add the com.apple.developer.declared-age-range entitlement to your app. Add it to your app config file:

{
  "expo": {
    "ios": {
      "entitlements": {
        "com.apple.developer.declared-age-range": true
      }
    }
  }
}

<key>com.apple.developer.declared-age-range</key>
<true/>

Usage

import * as AgeRange from 'expo-age-range';
import { useState } from 'react';
import { StyleSheet, Text, View, Button } from 'react-native';

export default function App() {
  const [result, setResult] = useState<AgeRange.AgeRangeResponse | { error: string } | null>(null);

  const requestAgeRange = async () => {
    try {
      const ageRange = await AgeRange.requestAgeRangeAsync({
        threshold1: 10,
        threshold2: 13,
        threshold3: 18,
      });
      setResult(ageRange);
    } catch (error) {
      setResult({ error: error.message });
    }
  };

  return (
    <View style={styles.container}>
      <Button title="Request Age Range" onPress={requestAgeRange} />
      {result && (
        <Text style={styles.result}>
          {'error' in result ? `Error: ${result.error}` : `Lower age bound: ${result.lowerBound}`}
        </Text>
      )}
    </View>
  );
}

const styles = StyleSheet.create({
  container: { flex: 1, justifyContent: 'center', padding: 20 },
  result: { marginTop: 20, fontSize: 16 },
});

Additional resources

• Play Age Signals API: Android documentation for age signals
• Declared Age Range framework: iOS documentation for declared age range

API

import * as AgeRange from 'expo-age-range';

Methods

Types

Error codes

Available in the code property of any error thrown by the native module. For Android-specific error codes, see "Handle API error codes" in Use Play Age Signals API docs