This document walks through the process of requesting and enabling the com.apple.developer.family-controls entitlement, required for apps using the Wellspent SDK.

<aside> 💡

Why This Matters:

The Family Controls entitlement grants access to Apple’s Screen Time APIs, enabling your app to make use of our SDK.

Apple approval is required for the distribution entitlement but the development entitlement can be enabled in Xcode.

</aside>

Step-by-Step Integration

1. Request Entitlement from Apple

To use the Family Controls distribution entitlement, you must first apply through Apple.

• Visit the Apple Family Controls Request Form.

• Provide details about your app’s use of Family Controls (e.g. screen time

  tracking).

• Approval times may vary. Apple will notify you via email once approved.

• 📌 Copy template for the form (expand to see)

2. Enable Family Controls in App Store Connect

Once your request is approved:

• Go to App Store Connect → Certificates, IDs & Profiles.
• Select Identifiers and choose your app.
• Under Capabilities, enable Family Controls.
• Repeat this step for all targets, including any App Extensions(e.g., DeviceActivityMonitor, ShieldAction, ShieldConfiguration).

3. Configure Your Xcode Project

In Xcode: