Reference library · App Review
Guideline 2.3 Accurate Metadata: where ASO tricks turn into App Review rejections
The only rejection you can usually fix without uploading a new build — and the one most often caused by bad ASO advice.
Guideline 2.32. Performance · Accurate MetadataApple text last updated June 8, 2026Checked against Apple's App Review Guidelines (last updated June 8, 2026) and App Store Connect help on statuses and replying to App Review, on Oct 2, 2026.
The short answer
Guideline 2.3 requires your name, subtitle, keywords, screenshots, previews and description to reflect what the app actually does. Common rejections: screenshots that don't show the app in use, names or keywords stuffed with competitor names or pricing words, and references to Android or Google Play. If only metadata is at fault, you can edit it and resubmit the same build.
- Sub-points
- 13
- 2.3.1 through 2.3.13
- New build needed
- Usually no
- If only metadata is at fault
- Name and subtitle
- 30 chars each
- No prices, no other apps' names
- Screenshots must show
- The app in use
- Not title art or a login screen
01What 2.3 covers
Customers should know what they're getting when they download or buy your app, so make sure all your app metadata, including privacy information, your app description, screenshots, and previews accurately reflect the app's core experience and remember to keep them up-to-date with new versions.
| Sub-point | In short | Typical trigger |
|---|---|---|
| 2.3.1 | No hidden or undocumented features; no misleading marketing | A feature flag reviewers can't see; vague review notes |
| 2.3.2 | Say clearly when featured items need extra purchases | Screenshots show premium features with no hint they're paid |
| 2.3.3 | Screenshots show the app in use | Marketing art, splash screens, a login page |
| 2.3.4 | Previews use screen captures of the app itself | Lifestyle footage or rendered animations |
| 2.3.7 | Unique name, accurate keywords, no trademarks, competitor names or pricing | "Free", "#1", or another app's name in the name, subtitle or keywords |
| 2.3.8 | All metadata suitable for a 4+ audience | A mature screenshot on a 17+ app; "For Kids" outside the Kids Category |
| 2.3.10 | No other platforms or marketplaces in the app or metadata | "Also on Android", a Google Play badge, an Android status bar in a screenshot |
02Screenshots and previews (2.3.3, 2.3.4)
Screenshots should show the app in use, and not merely the title art, login page, or splash screen. They may also include text and image overlays (e.g. to demonstrate input mechanisms, such as an animated touch point or Apple Pencil) and show extended functionality on device, such as Touch Bar.
Captions and framing are allowed — the rule is that the app's real interface is what the screenshot is about. A typical rejection reads: "We noticed that your screenshots do not sufficiently reflect your app in use." The usual causes:
- The first screenshot is a poster. A headline and an illustration, with no interface. Lead with a real screen and put the headline above it.
- The wrong device. Screenshots in a frame that doesn't match the size class they were uploaded for.
- Features that aren't in the build. If the screenshot shows it, the reviewer will look for it.
- Previews that aren't screen recordings. 2.3.4 says previews "may only use video screen captures of the app itself". Narration and text overlays are fine.
03Names, subtitles and keywords (2.3.7)
Choose a unique app name, assign keywords that accurately describe your app, and don't try to pack any of your metadata with trademarked terms, popular app names, pricing information, or other irrelevant phrases just to game the system.
This is the sub-point where common ASO advice collides with App Review. Several widely repeated tactics are exactly what the guideline names:
Gets rejected
- A competitor's name in your keyword field — Apple's reference says names of other apps or companies aren't allowed
- "Free", "50% off" or a price in the name, subtitle or screenshots
- "#1" or "best" in the subtitle — subtitles may not "make unverifiable product claims"
- Keywords for things the app doesn't do
Works, and passes
- Brand plus the category phrase, within 30 characters
- A subtitle that names the audience or the outcome
- Keywords for features and use cases you actually have
- Proof — awards, user counts — in promotional text, where Apple suggests accolades go
Apple also reserves the right to change things for you: it "may modify inappropriate keywords at any time". For what top apps do inside these limits, see the listing snapshots for calorie trackers and habit trackers.
04Mentions of other platforms (2.3.10)
2.3.10 tells you not to include "names, icons, or imagery of other mobile platforms or alternative app marketplaces in your app or metadata". It's an easy one to trip in a cross-platform app, because the offending content is often inside the app rather than the listing.
Search your app and listing for
- "Android", "Google Play", "Play Store" in the description, What's New, and in-app text
- Store badges on a website shown in a web view, or on a 'share the app' screen
- Screenshots taken on an Android device or showing a non-iOS status bar
- Onboarding or settings copy shared with the Android build
- Device mock-ups in screenshots that aren't Apple devices
A real example: "Revise the app's home page to remove Google Play references." When the reference is inside the app, the fix needs a new build — the one case where a 2.3 rejection isn't metadata-only.
06Fixing a "Metadata Rejected" status
App Review didn't accept your metadata. Read the message from App Review, edit the metadata to resolve the issue, and reply to the message from App Review.
Read which field is named
The message usually names the element — screenshots for a device size, the app name, the description.
Edit it in App Store Connect
Fix every locale, not only the one quoted — the same problem in another localization can be flagged on the next submission.
Reply, don't re-upload
Apple's help says: "If your app was rejected for a metadata issue, you can resubmit the same build after resolving the issue."
Check the app for the same problem
If the offending text or image also appears inside the app, a metadata edit won't be enough — ship a new build.
Hello App Review team,
Thank you for the feedback on Guideline 2.3.[sub-point].
Metadata changes (no new build):
- Replaced the first two 6.9-inch screenshots; both now show the app's
[screen name] in use.
- Removed "[word]" from the app name and subtitle in all localizations.
- Removed the reference to [other platform] from the description.
The binary is unchanged. Please let us know if anything else needs attention.
Thank you,
[Name]Frequently asked questions
Do I need a new build to fix a metadata rejection?
Not if the problem is only in the listing. Apple says you can resubmit the same build after resolving a metadata issue. You do need a new build if the offending content also appears inside the app.
Can I put a competitor's name in my keyword field?
No. 2.3.7 prohibits packing metadata with trademarked terms and popular app names, and Apple's keyword reference says names of other apps or companies aren't allowed. Apple may also modify keywords itself.
Can my screenshots have text and device frames?
Yes. 2.3.3 allows text and image overlays. What's required is that the screenshots show the app in use rather than only title art, a login page or a splash screen.
Can I say "free" in my app name or subtitle?
No. Under 2.3.7, names, subtitles, screenshots and previews should not include prices or terms that aren't specific to that metadata type. Pricing is already shown on the product page.
Can I mention that my app is also on Android?
Not in the app or its App Store metadata. 2.3.10 bars names, icons or imagery of other mobile platforms or alternative marketplaces unless there's specific, approved interactive functionality.
Where to go next
- Promotional textThe field for accolades and offers — and the one you can change without review.
- ASO for indie iOS appsWriting a name and subtitle that rank without breaking 2.3.7.
- Guideline 4.3: SpamWhen a listing copied from the category leader triggers a different rejection.
- The Review Check — $49Your listing and build checked against the guidelines before you submit.
Sources
- App Store Review Guidelines — 2.3 Accurate Metadata — Apple Developer
- App and submission statuses — App Store Connect Help
- Reply to App Review messages — App Store Connect Help
- Platform version information — keywords — App Store Connect Help
- New creative assets for the App Store (Aug 5, 2026) — Apple Developer News
- Forum: screenshots don't reflect the app in use (2.3.3) — Apple Developer Forums
- Forum: third-party platform references (2.3.10) — Apple Developer Forums
Published Oct 2, 2026 · last checked Oct 2, 2026. Found something out of date? Tell us and we'll fix it within a day. Machine-readable version: /app-review/guideline-2-3-accurate-metadata.md
Have it done for you
The Review Check
$49 one-time · Delivered in 2 business days
Send us your listing and TestFlight build before you submit. We check screenshots, name, keywords and the build itself against the guidelines that reject indie apps.
- Written pass / fail read against the guidelines that actually reject indie apps — 3.1.1 in-app purchase, 5.1.1 data and privacy, account deletion, Sign in with Apple, privacy manifest and nutrition labels, subscription disclosure, metadata claims
- The exact fix for every flag, in the order to do them
- One re-check of the fixed build, included