Version 1.0.0 stuck in "Waiting for Review" for ~2 weeks after an automated Guideline 2.5.1 message about the Family Controls entitlement

Our app — a screen-time / focus app — has had no App Review activity for two weeks, and we believe the trigger was an automated Guideline 2.5.1 check that froze an otherwise actively progressing review. (This forum account is linked to the developer account in question; we can provide the App ID, bundle IDs, submission IDs, and support case numbers through any private channel on request.) Context:

  • Jul 2–5: Our first submission (Version 1.0.0) was under active review. We went through several ordinary metadata / paywall-related iterations, and the reviewer responded within roughly 24 hours each time. Nothing related to Screen Time was raised in these human reviews of builds 9 and 10.
  • Jul 8: After we submitted build 11 — which addressed the remaining human-review feedback — we received an automated Guideline 2.5.1 (Performance: Software Requirements) message stating that the app uses the Screen Time API but has not been submitted with the Family Controls entitlement, and that review of the submission cannot proceed.
  • All reviewer activity stopped at that point, and there has been none since.

What we verified:

  • The Family Controls (Distribution) entitlement is granted to our account and assigned to all four bundle IDs (the main app plus its DeviceActivityMonitor, ShieldAction, and ShieldConfiguration extensions). We verified with codesign that com.apple.developer.family-controls = true is present in the code signature and embedded provisioning profile of every one of the four executables in the submitted IPA — so the entitlement named in the automated message is present in the flagged build.
  • For context: builds 9 and 10, with an identical Screen Time API surface and identical entitlements (verified at the binary level with nm against the submitted artifacts), had been human-reviewed on Jul 2–5 with no Screen Time-related objection. We recognize those builds may simply not have reached the automated analysis stage before being superseded, so we do not draw firm conclusions from that.

What we did anyway (build 12, submitted Jul 9):

  • In case the automated check actually concerns the separate com.apple.developer.family-controls.app-and-website-usage entitlement (which we do not request and do not need), we removed every reference from our main app to the APIs associated with it: AuthorizationStatus.approvedWithDataAccess, ManagedSettings.Application.bundleIdentifier, ManagedSettings.Application.localizedDisplayName, ManagedSettings.ActivityCategory.localizedDisplayName, and ManagedSettings.WebDomain.domain. We verified with nm that none of the four executables in the build 12 IPA reference these APIs.
  • The app does not use FamilyActivityData, DeviceActivityReport, app usage events, web usage events, or App and Website Usage data access.
  • No automated message has appeared for build 12.

What has happened since:

  • Jul 9–14: No reviewer activity on build 12. We filed an expedited review request and opened two Developer Support cases (Jul 8 and Jul 14). No response to any of them.
  • Around Jul 15: Hoping to clear the frozen state, we cancelled and resubmitted the same Version 1.0.0 / build 12.
  • Around Jul 17: Filed a second expedited review request for the new submission.
  • Jul 22 (today): The new submission has been in "Waiting for Review" since Jul 15, with no reviewer activity and no reply to either support case or either expedite request.

What we are asking:

  1. Could someone check whether the Jul 8 automated flag is still attached to the app record and blocking reviewer assignment, and help get the current submission assigned to a reviewer?
  2. If the automated check flags build 12 again, could the message specify which entitlement and which binary / API references triggered it, so we can address it precisely? We can provide codesign output, entitlement plists, provisioning profile dumps, and nm symbol listings on request.

Thank you.

I'm hitting exactly this, on a different team, so here's a second case in case it helps show this isn't just one misconfigured project.

I uploaded a build in late July, signed with Apple Distribution. App Store Connect validation passed cleanly, no warnings. I submitted it the same afternoon, and the next day got the same automated Guideline 2.5.1 message: the app uses Screen Time APIs but wasn't submitted with the Family Controls entitlement, so review can't proceed.

As far as I can tell, it was. Family Controls (Distribution) is approved and Assigned for the main App ID and all four of my extension App IDs, covering a DeviceActivityMonitor extension, a ShieldConfiguration extension, a ShieldAction extension and a DeviceActivityReport extension. The App Store Connect API confirms FAMILY_CONTROLS and FAMILY_CONTROLS_DISTRIBUTION on all five, and all ten of my provisioning profiles (development and App Store, for all five App IDs) carry com.apple.developer.family-controls = true.

I also checked the entitlements App Store Connect recorded for the uploaded build itself, rather than just my local archive, and com.apple.developer.family-controls is set to true on the main app executable and on all four .appex binaries.

Worth noting I ship a DeviceActivityReport extension as well, so five targets rather than four, and it gets flagged the same way. So this doesn't look tied to any one extension type.

Two things I'd love an answer on. Is the automated flag still attached to my app record and holding up reviewer assignment? And if a build gets flagged again, could the message say which binary and which API set it off? Right now there's genuinely nothing for me to fix, since by Apple's own record of the upload the entitlement is on everything.

Glad to hand over my Team ID, build ID or submission ID to anyone at DTS or App Review who can dig into it.

Adding a third case with the same signature, plus one piece of evidence I haven't seen in this thread yet.

Same app structure as the original post: main app plus three Screen Time extensions — DeviceActivityMonitor, ShieldAction, ShieldConfiguration.

Timeline:

  • 2026-07-11 — build 1.0.0 (1) submitted. Cleared automated analysis, reached human review, and was rejected 2026-07-13 on guidelines 3.1.2(c), 5.6 and 2.3.2. No Screen Time or Family Controls issue was raised.
  • 2026-07-27 — build 1.0.0 (3) uploaded. Zero entitlement or code-signing changes from build 1 (verified by diff).
  • 2026-08-01 — rejected by automated pre-review analysis: "An automated analysis indicates the app uses one or more Screen Time APIs but the app has not been submitted with the Family Controls entitlement."

The evidence I'd suggest others check: instead of verifying with codesign locally, look at App Store Connect's own record. Under TestFlight > iOS Builds > [your build] > Build Metadata > Store Information there is an Entitlements section listing the entitlements Apple parsed out of the binary it received. For our rejected build it shows:

Recess.app/Recess — com.apple.developer.family-controls: true Recess.app/PlugIns/ShieldConfiguration.appex/ShieldConfiguration — com.apple.developer.family-controls: true Recess.app/PlugIns/DeviceActivityMonitor.appex/DeviceActivityMonitor — com.apple.developer.family-controls: true Recess.app/PlugIns/ShieldAction.appex/ShieldAction — com.apple.developer.family-controls: true

Binary State: Validated.

So App Store Connect's own record of the received binary lists the entitlement on all four executables, while the automated analysis says the app was not submitted with the entitlement. Both statements come from the same system.

Also confirmed on our side: Family Controls (Distribution) is enabled on all four App IDs, and forcing a fresh provisioning profile mint on 2026-08-01 produced four new App Store profiles — app plus all three extensions — every one containing com.apple.developer.family-controls, with a successful App Store export.

Version 1.0.0 stuck in "Waiting for Review" for ~2 weeks after an automated Guideline 2.5.1 message about the Family Controls entitlement
 
 
Q