Home / App rejections: fix guides for App Store and Google Play / Apple app approval: how App Review works and why apps fail

Guide · Rejections

Apple app approval: how App Review works and why apps fail

How Apple app approval works, what App Review checks, the guidelines that cause most rejections, and a pre-submission checklist from an iOS developer.

Quick answer: Apple app approval happens in App Review, where a person checks your build and metadata against the App Store Review Guidelines. Most rejections we see fall under completeness (2.1), metadata (2.3), payments (3.1.1), spam (4.3) and privacy (5.1). A pre-submission checklist and a clear review note prevent most of them.

What App Review checks

App Review looks at your build, your App Store metadata (name, screenshots, description, privacy details) and the notes you leave for the reviewer. The rules are in the App Store Review Guidelines, grouped into Safety, Performance, Business, Design and Legal.

The rejections we see most

  • 2.1 App Completeness: crashes, broken links, missing demo login. Fix
  • 2.3 Metadata: screenshots or text that don't match the app. Fix
  • 3.1.1 In-App Purchase: digital goods sold outside IAP. Fix
  • 4.3 Spam: apps too similar to others. Fix
  • 5.1.1 Privacy: unclear permission prompts, missing account deletion. Fix

Pre-submission checklist

  1. Test the release build on a real device, on the latest iOS.
  2. Add a demo account with sample data in App Review Information.
  3. Check every link in the app and the listing works, including the privacy policy.
  4. Permission purpose strings explain why you need each permission.
  5. Account creation means in-app account deletion.
  6. Screenshots show the actual app.
  7. Digital content and subscriptions use In-App Purchase where required.

If you're rejected

Read the message for the guideline number, then open the matching guide in the rejection hub. Reply calmly in App Store Connect, or appeal if you think the reviewer misunderstood.

Review notes that help

Explain anything non-obvious: hardware the app needs, region-locked features, where to find the feature the reviewer asked about, and a demo account that won't expire.

How to prepare a submission, step by step

Follow these steps in order. Each one is something we do on client work.

  1. Freeze the build. Archive a release build, install it through TestFlight on a real device running the current iOS, and use it the way a stranger would: fresh install, no saved login.
  2. Walk every screen. Tap every button, link and purchase path. Guideline 2.1 expects final versions with fully functional URLs, so a dead Terms link alone can sink the review.
  3. Write App Review Information. Add a demo account that will not expire and has sample data, plus notes explaining hardware, region locks or hidden features. The Notes field holds up to 4,000 bytes.
  4. Match metadata to the build. Check the name, subtitle, screenshots and description against the build you are sending. Guideline 2.3 asks that metadata reflects the core experience.
  5. Check payments and privacy. Digital unlocks go through In-App Purchase (3.1.1); account creation needs in-app deletion (5.1.1(v)); every permission needs a clear purpose string.
  6. Submit and watch Resolution Center. Reply inside App Store Connect within the same thread. Short, specific replies that point to screens get resolved fastest in our experience.

Worked example (hypothetical)

This example is illustrative. The app is made up, and so are any numbers in it.

Say a habit-tracker called Streakly is rejected under 2.1 because the reviewer could not get past sign-up. The fix is not a rebuild. We would add a demo account in App Review Information, note in the Notes field that the email-code step is skipped for that account, and reply in Resolution Center with the login and the exact path to the premium screen. We would also check that the paywall's Terms and Privacy links open real pages, because a reviewer who finds one dead link usually finds a second.

The guidelines behind most rejections

Every row below is quoted or summarised from Apple's current App Review Guidelines. Check the numbers in your rejection message against it.

GuidelineWhat it coversUsual fix
2.1 App CompletenessFinal builds, working URLs, no placeholder contentFix crashes, add a demo account, test every link
2.3 Accurate MetadataDescription, screenshots and previews reflect the appRe-shoot screenshots from the real app; remove claims you can't show
2.3.7Unique name, accurate keywords, no trademarked or irrelevant termsRemove competitor names and pricing from metadata
3.1.1 In-App PurchaseDigital features and content unlocked via IAPMove digital unlocks to StoreKit IAP
4.2 Minimum FunctionalityMore than a repackaged websiteAdd native, useful features
4.3 SpamNo duplicate bundle IDs or saturated copycat appsConsolidate apps; show what is unique
5.1.1 Data Collection and StoragePrivacy policy, permissions, account deletion (5.1.1(v))Add policy links, clear purpose strings, in-app deletion

App Store text fields and their limits

These are the limits App Store Connect enforces today. Plan your copy against them before you write a word.

FieldLimitNotes
App name2–30 charactersShown on the product page and in search
Subtitle30 charactersAppears under the name
Keywords100 bytesComma-separated, each keyword more than two characters; don't repeat app or company name; no other app or company names
Promotional text170 charactersAbove the description; can change without a new submission
Description4,000 charactersPlain text, no HTML
What's New4,000 charactersRequired for every version after the first

Common mistakes

  • Leaving the demo account blank. Reviewers will not create accounts with real phone numbers for you.
  • Screenshots from an older version. They no longer match the build, which is a 2.3 problem.
  • Arguing in the reply. State facts and point to screens; save disagreement for a formal appeal.
  • Fixing one issue and ignoring the rest. Reviewers often list several guidelines. Answer each one by number.

Checklist

Copy this list into your release notes or ticket and tick each item off before you ship.

  • Release build tested on a real device, clean install
  • Demo account with sample data in App Review Information
  • Every in-app and listing link opens a real page
  • Screenshots captured from this build
  • Digital unlocks use In-App Purchase
  • In-app account deletion if accounts exist
  • Purpose strings for each permission
  • Review notes explain anything non-obvious

Sources

FAQ

Questions

How long does Apple app approval take?

Apple says most submissions are reviewed within 24 hours; complex apps or busy periods take longer.

Can I expedite review?

Yes, Apple accepts expedited review requests for critical fixes.

Is TestFlight review the same?

External TestFlight builds get a lighter beta review; the full review happens on App Store submission.

Do rejections affect future reviews?

Not by themselves, but repeated spam or deceptive behaviour can lead to account action.

Can you fix my rejection?

Yes: App Rejection Fix, 1–2 business days.

What goes in the App Review Notes field?

Anything the reviewer needs to test the app: a demo login, where a feature lives, required hardware or region. Apple allows up to 4,000 bytes.

Ready when you are

$99 one-timeDelivered in 2–3 business days2 revisionsNo login needed
Questions? WhatsApp
Rank higher. More installs.Want your app ranked and more installs?
Get HireASO