<!--
{
  "availability" : [
    "iOS: 26.0.0 -",
    "iPadOS: 26.0.0 -",
    "macCatalyst: 26.0.0 -",
    "macOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DeclaredAgeRange",
  "identifier" : "/documentation/DeclaredAgeRange/AgeRangeService",
  "metadataVersion" : "0.1.0",
  "role" : "Structure",
  "symbol" : {
    "kind" : "Structure",
    "modules" : [
      "Declared Age Range"
    ],
    "preciseIdentifier" : "s:16DeclaredAgeRange0bC7ServiceV"
  },
  "title" : "AgeRangeService"
}
-->

# AgeRangeService

A request for the age range of a person
logged onto the current device.

```
struct AgeRangeService
```

## Overview

Use `AgeRangeService` to request a person’s age range and manage their access to content on your app. This service enables
you to create age-appropriate experiences while respecting people’s privacy and meeting regulatory requirements.
The system presents an interface that describes the data you’re requesting and asks people to grant permission to share their age range with your app.

The following code demonstrates how to request a person’s age range and determine what content to display
on your app’s landing page based on their age group:

**SwiftUI:**

```swift
import SwiftUI
import DeclaredAgeRange

@Environment(\.requestAgeRange) var requestAgeRange

func checkAgeRange() async {
    guard let response = try? await requestAgeRange(ageGates: 13, 15, 18),
    case let .sharing(ageRange) = response else {
        return // Person declined sharing, or other error.
    }

    guard let lowerBound = ageRange.lowerBound else {
        // Person is under 13; enable age-appropriate experience.
        return
    }

    if lowerBound >= 18 {
        // Enable features for age 18 and older.
    } else if lowerBound >= 15 {
        // Enable features for ages 15-17.
    } else {
        // Enable features for ages 13-14.
    }
}
```

**UIKit and AppKit:**

```swift
// import UIKit for iOS and iPadOS.
// import AppKit for macOS.
import DeclaredAgeRange

func checkAgeRange() async {
    guard let response = try? await requestAgeRange(
        ageGates: 13, 15, 18,
        in: viewControllerOrWindow // Use UIViewController in UIKit or NSWindow in AppKit.
    ),
    case let .sharing(ageRange) = response else {
        return // Person declined sharing, or other error.
    }

    guard let lowerBound = ageRange.lowerBound else {
        // Person is under 13; enable age-appropriate experience.
        return
    }

    if lowerBound >= 18 {
        // Enable features for age 18 and older.
    } else if lowerBound >= 15 {
        // Enable features for ages 15-17.
    } else {
        // Enable features for ages 13-14.
    }
}
```

The system may override your age gates based on the local regulations of the person’s geographic location.
Age ranges provide the minimum information necessary for content decisions while protecting privacy.
Parental controls and family sharing settings may affect the availability and accuracy of age information.

## Topics

### Retrieving the shared instance

[`shared`](/documentation/DeclaredAgeRange/AgeRangeService/shared)

The singleton app instance for accessing age range services.

### Getting the age range

[`AgeRangeService.AgeRangeDeclaration`](/documentation/DeclaredAgeRange/AgeRangeService/AgeRangeDeclaration)

Constants that describe how an adult, parent, or guardian set the age range.

[`AgeRangeService.AgeRange`](/documentation/DeclaredAgeRange/AgeRangeService/AgeRange)

Information about a person’s age range based on their response to your age range request.

[`requestAgeRange(ageGates:_:_:in:)`](/documentation/DeclaredAgeRange/AgeRangeService/requestAgeRange(ageGates:_:_:in:)-2go8c)

Requests an age range for the person signed in to iCloud on the device.

[`requestAgeRange(ageGates:_:_:in:)`](/documentation/DeclaredAgeRange/AgeRangeService/requestAgeRange(ageGates:_:_:in:)-4yo3r)

Requests an age range for the person logged onto iCloud on the device.

[`AgeRangeService.Response`](/documentation/DeclaredAgeRange/AgeRangeService/Response)

A response indicating whether a person shared their age range or declined to share it.

[`AgeRangeService.ParentalControls`](/documentation/DeclaredAgeRange/AgeRangeService/ParentalControls)

An option set to define parental controls enabled and shared as a part of age range declaration.

### Accessing regulatory features

[`isEligibleForAgeFeatures`](/documentation/DeclaredAgeRange/AgeRangeService/isEligibleForAgeFeatures)

A Boolean value that indicates whether an adult, teen, or child is eligible for age-gated features.

### Defining regulatory features

[`AgeRangeService.RegulatoryFeature`](/documentation/DeclaredAgeRange/AgeRangeService/RegulatoryFeature)

Defines the regulatory features that your app may need to support.

[`requiredRegulatoryFeatures`](/documentation/DeclaredAgeRange/AgeRangeService/requiredRegulatoryFeatures)

A set of regulatory features that are required for the person.

### Displaying update acknowledgments

[`showSignificantUpdateAcknowledgment(in:updateDescription:)`](/documentation/DeclaredAgeRange/AgeRangeService/showSignificantUpdateAcknowledgment(in:updateDescription:))

Displays a system-provided interface for people to acknowledge a significant app update.

### Handling errors

[`AgeRangeService.Error`](/documentation/DeclaredAgeRange/AgeRangeService/Error)

An error that occurs when an age range request fails.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)