# App store review notes

Apple and Google review every submission before the app appears in the store; a demo account for the reviewers and complete metadata prevent the most common rejections.

> Source: https://www.application-platform.com/en/docs/app-store-review/

After the manual `release-ios` job, Apple reviews the app before it appears in the App Store. With Google, the review runs after `release-android` has promoted the build to the Production Track. Both reviews run against the live state, that is, against the production environment and the real store texts.

## Demo access for the reviewers

If the app has a login, the reviewers need a working demo account. You store it in the app repository under `ios/fastlane/metadata/review_information/` in three files: `demo_user.txt` contains the username, `demo_password.txt` the password, and `notes.txt` notes for the reviewers, for example about special aspects of the app. The account must work in the production environment because the reviewers test the live state.

## Common reasons for rejection

Most rejections have a handful of causes. Description, screenshots, and privacy details must match the actual app; how to maintain them in the repository is described under [Store metadata]({{< relref "store-metadata" >}}). Placeholders such as empty screens, "lorem ipsum", or dead links reliably lead to rejection. Crashes on launch are the first thing reviewers notice; that is exactly why the platform stages every build in TestFlight and the Internal Track first, where you can try the release build before submitting it. The privacy policy at the privacy URL and, where required, a legal notice must be reachable. Every permission for camera, location, or tracking needs an understandable justification in the app.

{{< docnote >}}
The first submission usually takes longer with Apple than later ones, often one to three business days and sometimes with questions. Plan for this time ahead of a launch date. Updates of an already published app usually pass much faster.
{{< /docnote >}}

## After a rejection

1. Read the reasoning in **App Store Connect** or the **Play Console**. It references the specific guideline the app violates.
2. Fix the issue, merge the change to `main`, and wait until the pipeline has published the new build.
3. Start `release-ios` or `release-android` again.

If Apple's reasoning remains unclear, you can reply and ask directly in the Resolution Center of App Store Connect.