# App Store rejection: how to fix it, guideline by guideline (2026)

> Fix an App Store rejection: read the cited guideline, reproduce the issue, reply in App Store Connect, then resubmit metadata, a new build or an appeal.

Canonical: https://makeyourapp.live/blog/app-store-rejection-how-to-fix
Last updated: 2026-10-18

By [Yagyesh Bobde](https://www.bobdeyagyesh.in) · Review fixes · Published Oct 11, 2026 · Updated Oct 18, 2026 · 7 min read

Turn a vague App Review message into a testable issue, then pick the right fix: corrected metadata on the same build, a new build or an appeal, plus a reply template.

## Short answer

To fix an App Store rejection, read the guideline App Review cites (often 2.1 App Completeness, 2.3 Accurate Metadata, 4.2 Minimum Functionality, 3.1.1 In-App Purchase or 5.1.1 privacy), reproduce the issue in the release build, and then act. If only metadata was wrong, resubmit the same build. If the app's behavior must change, upload a new build. If you believe the app already complies, reply first and then file one appeal with the App Review Board.

## Key takeaways

- If an app is rejected only for a metadata issue, Apple lets you fix it and resubmit the same build. Behavior, crash or purchase-flow problems need a new build.
- Reply from App Store Connect: Apps → your app → unresolved issues link → Resolve → Reply to App Review. You can attach files until you resubmit.
- Before you appeal, reply to App Review. Then file only one appeal per rejected app, covering every cited guideline in that single appeal.
- Apple updated the App Review Guidelines on October 16, 2026. Hidden, dormant or undocumented features moved to the new 2.5.19, so check live numbering before you cite it.
- Guideline 4.2 asks for features, content and UI that go beyond a repackaged website. Rewording the description rarely fixes a 4.2 rejection.

An **App Store rejection** is a message from App Review that cites a guideline, says what the reviewer saw and holds the release until you fix it, explain it or appeal. Start by turning that message into an issue you can test. The next step depends on whether the reviewer couldn't use the app, found a policy mismatch or needs more information. As of October 2026, the [App Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) were last updated on October 16, 2026, so check the live numbering before you quote a section.

## What does an App Store rejection message actually tell you?

An App Store rejection message names the guideline the reviewer applied, describes the specific behavior they saw and lists next steps. It often includes the device, the iOS version and screenshots.

Save the full message, any screenshots, the build number and the device details. Read the cited section on the live guidelines page. Then write one sentence: "The reviewer could not complete X because Y." If the message asks for missing information rather than reporting a defect, write down exactly what is missing. Apple's standard 2.1 text also tells you how to reproduce the issue: "For new apps, uninstall all previous versions of your app from a device, then install and follow the steps to reproduce the issue."

- Does the message name a crash, an inaccessible screen or an incomplete feature? Reproduce that flow in the submitted release build, on the device type Apple named.
- Does it name screenshots, the description or review notes? Check whether you can fix it in metadata alone.
- Does it name payments, login, privacy or minimum functionality? Compare the product's behavior with the cited guideline.

## Which guidelines do App Store rejections cite, and what do they require?

Each guideline sets a concrete requirement, so match the cited number to its wording and test against that wording. The table quotes the current text of the guidelines that rejection messages commonly cite.

| Guideline | What Apple's text requires | What to check before resubmitting |
| --- | --- | --- |
| 2.1(a) App Completeness | Final versions with "fully functional URLs", demo account info "(and turn on your back-end service!)" | Crashes, placeholder content, login on iPhone and iPad, a live backend |
| 2.1(b) In-app purchases | Purchases must be "complete, up-to-date, visible to the reviewer and functional" | Products submitted and reachable, and the reason explained in review notes if any can't be found |
| 2.3 Accurate Metadata | Metadata must "accurately reflect the app's core experience" | Screenshots show the app in use, and the description matches this build |
| 4.2 Minimum Functionality | "features, content, and UI that elevate it beyond a repackaged website" | Native workflows, and no app that is mainly web clippings or links (4.2.2) |
| 3.1.1 In-App Purchase | To unlock features or functionality "you must use in-app purchase" | No license keys, QR codes or other unlock mechanisms, and any storefront entitlements in place |
| 5.1.1(v) Account Sign-In | "If your app supports account creation, you must also offer account deletion within the app." | A deletion flow reachable inside the app |

The October 16, 2026 update added **2.5.19** for hidden, dormant or undocumented features, which used to be covered under 2.3.1. It also added **2.3.14** on creative assets and folded the Music Streaming Services entitlement into the StoreKit External Purchase Link entitlement under 3.1.1(a). Treat the table as a starting point, not a guaranteed fix. One guideline can cover different problems, and the reviewer's example is the concrete case you have to resolve.

## How do you fix a 4.2 minimum functionality rejection?

Fix a 4.2 rejection by adding real app value, not by rewording the description. Guideline 4.2 says: "If your app is not particularly useful, unique, or 'app-like,' it doesn't belong on the App Store."

Ask what someone can do in your app that makes it useful as an app. They might complete a workflow, save meaningful state, use device capabilities in a way that fits the app, or get a mobile experience built for the device. No published feature list guarantees approval. If those workflows already exist, list them in review notes with exact steps and screenshots. If the app mostly shows a web page, it needs product work. Adding notifications or an empty settings screen just to look native doesn't replace real value for users.

## How do you reply to App Review in App Store Connect?

Reply in App Store Connect: open the submission from the app's unresolved issues link, click Resolve, then click Reply to App Review. Per [Apple's help page](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/reply-to-app-review-messages), this requires the Account Holder, Admin or App Manager role.

1. In **Apps**, select the app.
2. At the top of the page, click the link that indicates there are unresolved issues.
3. In the **In Progress** section, click **Resolve** next to the submission.
4. Click **Reply to App Review** and enter your text.
5. To include screenshots or documents, click **Attach File**, then click **Reply**.

Apple says you can correspond and attach files "until you resubmit to App Review", so send your evidence before you resubmit. Keep the reply short and factual: say what changed, where it is and how to verify it. Don't argue about other apps that seem to do the same thing.

> **RESPONSE TEMPLATE:** "Thank you for the details. We reproduced the issue in [flow]. Build [number] fixes [specific change]. To verify: 1) [step], 2) [step], 3) [expected result]. The review account remains [access details]." Only claim a fix you have tested. If you can't reproduce the issue, share your test conditions and ask for the missing detail.

## Should you fix metadata, upload a new build or appeal?

Fix metadata and resubmit the same build when only listing information was wrong. Upload a new build when the app's behavior has to change. Appeal only when you believe the app already complies with the guideline.

| Option | When it fits | What Apple says |
| --- | --- | --- |
| Metadata fix | Screenshots, description, privacy info or review notes were wrong | "If your app was rejected for a metadata issue, you can resubmit the same build after resolving the issue." |
| New build | Crashes, login, permissions or purchase flows need code changes | Increase the build number and test the exact revised flow first |
| Appeal | You believe the decision misapplies a guideline | Reply first, then submit "one appeal per rejected or removed app" covering every cited violation |

Apple's [appeal guidance](https://developer.apple.com/help/app-review/after-submitting-for-review/appeal-to-the-app-review-board) asks you to "explain point by point how your app meets" the guideline. It also says not to appeal after you've already fixed the issues and resubmitted. A complete appeal "does not guarantee" that the decision will be overturned. For apps already on the store, the guidelines' Bug Fix Submissions policy says bug fixes won't be delayed over guideline violations "except for those related to legal or safety issues".

## How did other developers fix real App Store rejections?

In public forum threads, many 2.1 rejections came from differences between the reviewer's setup and the developer's: a different network, device or permission state. A 4.2 rejection is a product problem, so small tweaks rarely clear it.

**Login error under 2.1.** A developer on the [Apple Developer Forums](https://developer.apple.com/forums/thread/120006) quoted the message "Specifically, we were not able to log in due to an error", even though the live and TestFlight versions logged in with the same credentials. Other developers in the thread reported different fixes. One fixed it by "changing http to https on web server". Another, after three rejections, added a "Check your connection" state instead of an endless loader. A third removed iPad from the deployment target after five rejections, which works around the problem by dropping iPad support.

**Crash on launch.** On the [Solar2D forum](https://forums.solar2d.com/t/reject-by-apple-store-connect-guideline-2-1-performance-app-completeness/357247), a developer was told "We were unable to review the app because it crashed on launch" on an iPhone 13 mini running iOS 18.3.2. The attached crash log showed a missing `NSUserTrackingUsageDescription` key. The developer confirmed: "It passed after adding : NSUserTrackingUsageDescription."

**WebView app under 4.2.** A developer on the [Apple Developer Forums](https://developer.apple.com/forums/thread/806726) reported a 10th rejection for a WebView-based app. The reviewer had sent a screenshot of the left menu saying it lacked content. The main screens were now native, but two or three still opened a WebView. The reply marked as the answer came from App Review and recommended a one-on-one App Review consultation. The thread doesn't confirm an approval.

The comparison: the 2.1 cases were fixed by reproducing the reviewer's conditions and reading the crash log. The 4.2 case stalled because each resubmission changed only part of an app that was still mostly a website.

## How do you stop the same rejection from happening again?

Turn each resolved issue into a release-checklist item and retest it in the release build before every submission. Apple's guidelines warn that review "will take longer" if an app is repeatedly rejected for the same guideline violation.

- Delete the app, then install the release build fresh on a physical iPhone and iPad.
- Log in with the review account on a network with no development servers or HTTP exceptions.
- Open every permission prompt and confirm that each Info.plist usage description exists.
- Make sure every in-app purchase is submitted, visible and explained in review notes.
- Update the review notes whenever a flow changes. Don't paste notes from six releases ago.

For 2.1 issues, follow the [release-build test plan for 2.1 rejections](https://makeyourapp.live/blog/app-store-rejection-2-1-release-build-test-plan) and set up a [reviewer demo account](https://makeyourapp.live/blog/app-store-review-demo-account-setup). Then work through the [submission checklist](https://makeyourapp.live/blog/app-store-submission-checklist) for the next build. If the review message still leaves you stuck, [send us the details](https://makeyourapp.live/#services) and we'll help you work out whether the missing piece is access, metadata or code.

## Frequently asked questions

### Can I resubmit the same build after an App Store rejection?

Yes, if the rejection was only about metadata. Apple's App Store Connect Help says: "If your app was rejected for a metadata issue, you can resubmit the same build after resolving the issue." Fix the screenshots, description, privacy details or review notes, then resubmit. If the reviewer found a crash, a broken login or a purchase problem, you need to change code, so upload a new build with a higher build number.

### How many times can you resubmit an app after it is rejected?

The App Review Guidelines set no limit on resubmissions. They do warn that if an app "is repeatedly rejected for the same guideline violation", review will take longer. Guideline 4.3 also says repeated spam-like submissions may lead to removal from the Apple Developer Program. Resubmit only after you've reproduced the issue and tested the fix.

### Does an App Store rejection hurt my developer account?

A single rejection that you fix doesn't put your account at risk under the published guidelines. The risk comes from patterns. Guideline 2.3.1(b) calls egregious or repeated misleading behavior "grounds for removal from the Apple Developer Program", and 4.3(b) warns about repeated copycat submissions. If your account faces termination and you believe it complies, Apple's process lets you appeal to the App Review Board.

### What is a Bug Fix Submission offer from App Review?

For apps already on the App Store or in alternative distribution, Apple won't delay bug fixes over guideline violations unless the violations involve legal or safety issues. If a bug-fix update is rejected and qualifies, reply to App Review in App Store Connect and say you want to use the process and will fix the issue in your next submission. You still have to fix it then.

### Should I appeal or just fix the app?

Fix the app if the reviewer found a real defect or policy gap. An appeal fits only when you believe the app already follows the guideline. Apple asks you to reply to the rejection first. Then submit one appeal per rejected app that explains point by point how the app meets the cited guideline. Don't appeal after you've already fixed the issue and resubmitted.

## Sources & further reading

- [Apple: App Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) (checked Oct 18, 2026)
- [Apple: Reply to App Review messages](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/reply-to-app-review-messages) (checked Oct 18, 2026)
- [Apple: Appeal to the App Review Board](https://developer.apple.com/help/app-review/after-submitting-for-review/appeal-to-the-app-review-board) (checked Oct 18, 2026)
- [Apple Developer Forums: App Rejected - Guideline 2.1 - Performance (login error)](https://developer.apple.com/forums/thread/120006) (checked Oct 18, 2026)
- [Solar2D Forums: Reject by Apple Store Connect, Guideline 2.1 crash on launch](https://forums.solar2d.com/t/reject-by-apple-store-connect-guideline-2-1-performance-app-completeness/357247) (checked Oct 18, 2026)
- [Apple Developer Forums: Guideline 4.2 - Design - Minimum Functionality](https://developer.apple.com/forums/thread/806726) (checked Oct 18, 2026)

## Related

- [App Store rejection 2.1 App Completeness: a release-build test plan before you resubmit (2026)](https://makeyourapp.live/blog/app-store-rejection-2-1-release-build-test-plan)
- [Guideline 4.3(a) Design Spam: how to fix it, with 4.3(b) and 4.2.6 explained for template and AI apps (2026)](https://makeyourapp.live/blog/guideline-4-3-a-design-spam-fix)
- [All posts](https://makeyourapp.live/blog)