# Guideline 2.3.1 - Accurate Metadata: Insufficient Review Notes for Major Update

**Guideline:** 2.3.1 · **Store:** Apple App Store · **Severity:** low · **Fix difficulty:** easy · **Typical turnaround:** 1-2 hours

Canonical URL: https://appstorereject.com/rejections/apple/2/guideline-231-accurate-metadata-insufficient-review-notes-for-major-update

## Description

Apple is rejecting your app update because the review notes don't explain major changes in the new version. When you submit an update with significant new features, redesigned UI, or changed functionality, Apple expects detailed review notes explaining what changed and how to test the new features. This rejection is particularly common when: (1) the app's primary category or purpose has changed, (2) a major UI redesign makes the app look completely different from the previous version, (3) new IAP or subscription features have been added, or (4) new permissions are requested without explanation. Apple reviewers compare your new submission against the currently live version. If the delta is large and the review notes are generic ('Bug fixes and improvements'), they'll reject for insufficient information rather than spend time guessing what changed.

## Common variations

- Review notes do not provide sufficient detail about changes
- App includes significant changes not explained in review notes
- New features were not documented in the review notes
- Major update requires detailed explanation of changes
- Please provide more information about the changes in this update

## Example rejection email

```
Guideline 2.3.1 - Performance - Accurate Metadata

Your app includes significant changes from the previous version, but the review notes do not provide sufficient detail about what has changed.

Specifically, the app appears to have undergone a major redesign and includes new features that were not explained in the review notes.

Next Steps:
Please update the Review Notes in App Store Connect to include:
- A detailed description of all changes made in this update
- Instructions for accessing and testing new features
- An explanation for any new permissions requested
- Updated demo account credentials if the sign-in flow has changed
```

## Resolution steps

## Quick Assessment
- **Risk level:** Low
- **Resolution path:** Update Review Notes and reply in Resolution Center
- **Typical turnaround:** 1-2 hours (no new binary needed)

## The Fix

1. **Write detailed review notes** -- For each major change, explain: what it is, why it was added, and how to test it. Include step-by-step instructions for reaching new features.

2. **Highlight new permissions** -- If you added camera, location, microphone, or other permissions, explain exactly when and why they're requested.

3. **Explain the redesign** -- If the UI changed significantly, describe the new navigation structure and key differences from the previous version.

4. **Provide screenshots or video** -- For complex features, include a link to a short video walkthrough in the review notes. Use an unlisted YouTube link or Loom.

5. **Update demo credentials** -- If the auth flow changed, provide fresh credentials and login instructions.

## Prevention
- Treat review notes as a change log for Apple, not for users
- For major updates, include a section-by-section breakdown of changes
- If your update touches IAP, permissions, or core navigation, always write detailed notes
- Template your review notes: 'What Changed', 'How to Test', 'New Permissions', 'Known Issues'

## Before / after examples

**Before:** Review Notes: 'Bug fixes and performance improvements.'
**After:** Review Notes: 'MAJOR CHANGES IN v3.0:\n1. Added video messaging (tap the camera icon in any chat thread)\n2. Redesigned home screen with new tab navigation\n3. Added premium subscription ($4.99/mo) -- accessible from Settings > Upgrade\n4. Now requests microphone permission for voice messages (triggered when user taps voice message button)\nDemo account: review@app.com / ReviewPass123'
**Why it works:** Apple needs enough detail to plan their review. Generic notes for a major update guarantee a rejection.

## Common questions

**How long does this typically take to fix?**

Typical turnaround is 1-2 hours (difficulty: easy). After resubmission, most re-reviews complete within 24-48 hours.

---
*Machine-readable source: https://api.appstorereject.com/api/rejections/detail?slug=guideline-231-accurate-metadata-insufficient-review-notes-for-major-update*