A metadata rejection rarely blocks your build for long, but it costs a review cycle, delays a launch date you probably announced, and forces you to redesign creatives under pressure. Most of these rejections trace back to one section of the App Review Guidelines: 2.3 Accurate Metadata.
The principle behind 2.3 is simple: customers should know what they are getting. Your description, screenshots, previews, and privacy information should reflect the app's core experience and stay current with each version. Everything below is a practical reading of that principle for screenshot work. It is not legal advice, and App Review always has the final word.
Apple's wording is direct: screenshots should show the app in use, not merely the title art, login page, or splash screen. Overlays are explicitly allowed—text captions, touch indicators, Apple Pencil, device frames—so marketing-style screenshots are fine as long as real UI is the star.
Common failures:
Fix: every frame should contain a recognizable, real screen from the current build. If you want a brand moment, put the logo above real UI rather than replacing it.
2.3.7 is mostly about the app name, subtitle, and keywords, but it also says metadata such as screenshots and previews should not include prices, terms, or descriptions that are not specific to the metadata type. In practice, screenshot captions get flagged for:
Fix: describe what the user can do, not what you claim to be. "Split bills with friends in seconds" survives review; "The #1 bill splitter, now 50% off" invites trouble.
2.3.10 asks you not to include names, icons, or imagery of other mobile platforms or alternative app marketplaces in your metadata unless there is specific, approved interactive functionality. Cross-platform teams hit this constantly because they reuse marketing assets:
Fix: keep a separate iOS export. A good mockup workflow makes this cheap—switch the frame and re-export rather than editing pixels by hand. Our device mockup tool and the screenshot editor let you produce clean platform-specific sets from the same source captures.
If a feature you highlight requires a subscription or in-app purchase, your screenshots and description should make that clear. A frame showing premium-only features with no indication they are paid is a classic paywall-related rejection. We cover this in depth in Subscription & Paywall Screenshots: App Store Compliance.
Run this before every submission that changes creatives:
Read the exact guideline cited. The rejection message in App Store Connect usually names the guideline number and often includes a screenshot of the problem. Don't guess; fix that thing first.
Metadata-only rejections can often be fixed without a new build. When the problem is only in screenshots or text, you can typically replace the assets in App Store Connect and resubmit. If the binary itself is fine, you avoid a rebuild.
Use the Resolution Center thoughtfully. If you believe the reviewer misread a frame—say, a "login" screen that actually shows onboarding content—reply calmly with context. Pointing to the guideline's own wording ("overlays are permitted…") works better than arguing.
Don't sneak it back in. Removing a claim for review and restoring it in the next update tends to cause repeat rejections and erodes trust with review.
Compliance and conversion are not opposites. The frames that survive review are usually the ones that convert best, because both reward clarity:
For a full framework on ordering frames and writing captions, see How to Make App Store Screenshots That Convert.
| What review flagged | Likely guideline | Fast fix |
|---|---|---|
| Splash/login-only frame | 2.3.3 | Replace with a real feature screen |
| "$2.99" or "50% off" in caption | 2.3.7 | Remove price; describe the benefit |
| "Better than [Competitor]" | 2.3.7 | Remove the name; state your own feature |
| Android frame or Play badge | 2.3.10 | Re-export with an Apple device frame or no frame |
| Premium features shown unlabeled | 2.3.2 | Add a subtle "Premium" or "Pro" label |
| Old UI that no longer exists | 2.3 (accuracy) | Recapture from the current build |
| Transparent PNG upload error | Spec, not review | Flatten to an opaque background |
Most screenshot rejections are avoidable with a five-minute check: real UI in every frame, no prices, no competitor names, no other-platform imagery, and paid features labeled. Build that checklist into your release process, keep platform-specific exports, and you will spend your review cycles on the binary instead of on pixels.