Documentation
Setup by Device
iPhone & iPad
FamilyControls Setup

iOS FamilyControls: System-Wide YouTube Blocking

Block YouTube across Safari, Chrome, and every browser on your child's iPhone or iPad β€” automatically. WhitelistVideo uses Apple's FamilyControls API to enforce protection at the system level.

FamilyControls is the recommended setup for iOS. It replaces most manual Screen Time configuration. If you've already set up Screen Time restrictions for YouTube, see Screen Time settings when using FamilyControls below.

What does FamilyControls do?

When enabled, WhitelistVideo uses Apple's built-in FamilyControls framework to:

  1. Block YouTube in all browsers β€” Safari, Chrome, Firefox, Edge, and any other browser on the device
  2. Shield apps β€” Completely block the YouTube app, TikTok, Instagram, Snapchat, and any other apps you choose
  3. Prevent bypass β€” Your child cannot access YouTube except through WhitelistVideo's filtered player
Without FamilyControlsWith FamilyControls
YouTube filtered inside WhitelistVideo onlyYouTube blocked everywhere except WhitelistVideo
Child can open Safari and watch YouTubeSafari, Chrome, all browsers β†’ YouTube blocked
YouTube app works normallyYouTube app blocked (if shielded)
Manual Screen Time config requiredAutomatic system-level enforcement

What do I need?

  • Your child's iPhone or iPad with iOS 16 or later
  • WhitelistVideo installed and activated on the device
  • Face ID, Touch ID, or device passcode to approve the setup
  • About 2 minutes

How to enable FamilyControls

On your child's iPhone or iPad

  1. Open the WhitelistVideo app

  2. If not already activated, activate with your parent code first

  3. A consent screen appears: "WhitelistVideo needs Screen Time access to block YouTube in browsers"

  4. Tap Allow Screen Time Access

  5. Authenticate with Face ID / Touch ID / passcode

  6. Select apps to shield (optional but recommended):

    • A list of apps appears β€” YouTube, TikTok, Instagram, Snapchat, etc.
    • Select which apps to completely block on this device
    • Tap Done (or "Skip for now" β€” you can configure this later in Settings)
  7. Setup complete β€” YouTube is now blocked system-wide except inside WhitelistVideo

That's it. No manual Screen Time configuration needed for YouTube blocking. FamilyControls handles it automatically.

Protection modes

WhitelistVideo automatically detects which protection mode is available on the device:

ModeWhen It AppliesWhat It Means
Child AccountDevice has a child Apple ID via Family SharingStrongest protection β€” child cannot revoke access, cannot delete the app, cannot sign out of iCloud
IndividualNo child Apple ID on the deviceBasic protection β€” child could potentially revoke access in Settings > Screen Time

The app tries Child Account mode first. If the device doesn't have a child Apple ID, it falls back to Individual mode.

⚠️

For strongest protection: Set up a child Apple ID through Family Sharing. With Individual mode, an older child could go to Settings > Screen Time and revoke WhitelistVideo's access.

What a child can do in Individual mode

In Individual mode, a child with access to device Settings can:

  • Go to Settings β†’ Screen Time β†’ scroll to the bottom β†’ tap Turn Off Screen Time to remove all restrictions
  • Go to Settings β†’ General β†’ VPN & Device Management to check for or remove configuration profiles

How to prevent this

Set up a child Apple ID via Family Sharing. With a child account:

  • The child cannot access Screen Time settings at all β€” only the parent can manage them remotely
  • The child cannot turn off Screen Time or revoke FamilyControls access
  • App deletion is blocked automatically without any additional configuration

How to check your protection mode

In the WhitelistVideo app on your child's device:

  1. Enter your PIN to access Settings
  2. Look for the Screen Time Protection row
  3. You'll see:
    • Status: Green checkmark (authorized) or red (revoked)
    • Protection mode: "Child Account" or "Individual"
    • Shielded apps: Number of apps blocked (e.g., "3 apps blocked")

App shielding

App shielding blocks specific apps at the iOS system level. When an app is shielded:

  • It shows an Apple system overlay and cannot be opened
  • The child cannot bypass it β€” it's enforced by iOS, not by WhitelistVideo
  • Shields are always active β€” they don't toggle on and off

Recommended apps to shield

AppWhy Shield It
YouTubePrevents using the native YouTube app to bypass filtering
TikTokShort-form video with algorithmic recommendations
InstagramSocial media with unfiltered content
SnapchatDisappearing content makes monitoring impossible

Managing shielded apps later

  1. Open WhitelistVideo on the child's device
  2. Enter your PIN to access Settings
  3. Tap Manage Shielded Apps
  4. Add or remove apps from the shield list

What gets blocked and what doesn't

YouTube domains blocked in browsers

FamilyControls blocks these domains system-wide:

  • youtube.com and www.youtube.com
  • m.youtube.com (mobile YouTube)
  • youtu.be (short links)
  • music.youtube.com (YouTube Music)

What still works

  • YouTube inside WhitelistVideo β€” plays normally with your filtering rules
  • Other websites β€” FamilyControls only blocks YouTube domains, not general browsing
  • App Store β€” still accessible (use Screen Time's Ask to Buy for control)
  • Apple's Screen Time settings β€” coexist with FamilyControls (they're separate systems)

Screen Time settings when using FamilyControls

If you've previously configured Screen Time to block YouTube, some settings now conflict with FamilyControls. Here's what to keep, change, and avoid:

Screen Time SettingRecommendationWhy
Deleting Apps β†’ Don't AllowKeep (Individual mode) / Not needed (Child Account)Child Account mode prevents deletion automatically
Web Content β†’ youtube.com in "Never Allow"REMOVE ITThis blocks YouTube inside WhitelistVideo too β€” FamilyControls handles browser blocking
Web Content β†’ Limit Adult WebsitesOptionalUnrelated to YouTube β€” use if you want general adult content filtering
Safari β†’ OffOptionalFamilyControls blocks YouTube in Safari regardless, but disabling adds extra safety
Always Allowed β†’ WhitelistVideoRecommendedEnsures WhitelistVideo works during Downtime
Installing Apps β†’ Ask to BuyRecommendedPrevents child from installing alternative apps
YouTube app β†’ 0-min limitNot needed if shieldedApp shielding handles this; Screen Time limit is the manual fallback
🚫

Do NOT add youtube.com to Screen Time's "Never Allow" list when using FamilyControls. This blocks YouTube in ALL apps including WhitelistVideo β€” with no exemption possible. FamilyControls handles YouTube blocking automatically and exempts WhitelistVideo.

If YouTube is blocked inside WhitelistVideo

If YouTube won't load inside the WhitelistVideo app:

  1. Go to Settings > Screen Time > Content & Privacy Restrictions > Content Restrictions > Web Content
  2. Check the "Never Allow" list β€” if youtube.com is there, remove it
  3. Set Web Content to "Unrestricted" or "Limit Adult Websites" (without YouTube in Never Allow)
  4. FamilyControls will continue blocking YouTube in browsers independently

Conflicts with other parental control apps

🚫

Apple allows only one third-party app to hold FamilyControls authorization per device. If another app already has Screen Time access, WhitelistVideo will show an error.

Apps that may conflict: Bark, Kidslox, Qustodio, OurPact, Net Nanny, Kaspersky Safe Kids, and other parental control apps that use Apple's FamilyControls or Screen Time API.

Apple's own Screen Time is NOT affected β€” it's a separate system that coexists with third-party FamilyControls apps.

How to resolve a conflict

  1. On the child's device, go to Settings > Screen Time
  2. Look for which third-party app has Screen Time access
  3. Remove that app's Screen Time access (or uninstall the app)
  4. Return to WhitelistVideo and tap Allow Screen Time Access again

For detailed steps, see Resolving FamilyControls Conflicts.

If you want to keep both apps

If you prefer to keep the other parental control app:

  • WhitelistVideo will still filter YouTube within its own app
  • You'll need to configure Screen Time manually to block YouTube in browsers
  • The other app can handle non-YouTube restrictions

Important limitations

iPad Split View

WhitelistVideo requires full-screen mode on iPad. This prevents the child from opening our app in one pane (which would disable the browser filter) while browsing YouTube in Safari in the other pane.

TestFlight builds

FamilyControls features do not work in TestFlight builds due to an Apple sandbox limitation. They work in App Store builds and development-signed builds.

Checking FamilyControls status

In the WhitelistVideo app Settings, the Screen Time Protection row shows:

  • Green checkmark β€” FamilyControls is active and protecting the device
  • Red indicator β€” Access was revoked (tap to re-authorize)
  • Not available β€” Device doesn't meet requirements (iOS 16+)

If access was revoked (e.g., by the child in Individual mode), tap the Re-authorize button to re-request access.

FamilyControls setup complete

With FamilyControls enabled:

  • YouTube is blocked in Safari, Chrome, and all browsers
  • Shielded apps (YouTube, TikTok, etc.) cannot be opened
  • Your child can only watch YouTube through WhitelistVideo's filtered player
  • Your filtering rules, whitelist, and blacklist all apply
Summarize with