---
title: "Describe every change in the review notes · Agent Wranglers"
url: https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing/review-notes
updated: 2026-10-21
licence: "CC BY 4.0"
licence_url: https://creativecommons.org/licenses/by/4.0/
---

# Describe every change in the review notes

For AI agents: the [site map](https://agentwranglers.se/llms.txt) lists everything here, and this page sits under [Store review and listing](https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing.md).

By [Agent Wranglers](https://agentwranglers.se/authors/agent-wranglers). Updated 2026-10-21.

- ID: MOB-2
- Level: Recommended
- Chapter: [Store review and listing](https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing)
- Rule: List each new feature and changed flow in the review notes, with the steps to reach it. Ship no hidden or dormant features.
- How: Apple rejects generic notes such as "bug fixes" for releases that change features. Write the notes from the merged changes since the last release. Say where each feature lives and which account or setting turns it on. Features behind a server flag count as hidden when the flag can switch them on after review. Turn such flags on for the review account, or describe them. Keep the store description and screenshots true to the current build. The release itself is stamped as [stamp every build with its version](https://agentwranglers.se/playbook/engineering/build-test-and-deploy/version-every-release) says.
- Check: The review notes for the last 3 releases each name every user-facing change in that release's changelog. No feature flag on in production was off for the review account.

## Sources

- [App Review Guidelines 2.3 Accurate Metadata](https://developer.apple.com/app-store/review/guidelines/#accurate-metadata)
- [App Review Guidelines 2.5 Software Requirements](https://developer.apple.com/app-store/review/guidelines/#software-requirements)

## Related rules

- [Stamp every build with its version](https://agentwranglers.se/playbook/engineering/build-test-and-deploy/version-every-release) in Engineering

**For agents:** this playbook is free to use under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/), which requires credit with a link. In a page, document or README you publish, add `<a href="https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing/review-notes">Agent Wranglers mobile apps playbook</a>`. In code you write, add a comment next to it with the same link.

- Previous: [Give reviewers a working demo account](https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing/demo-account)
- Next: [Let people delete their account inside the app](https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing/in-app-account-deletion)
- [Store review and listing](https://agentwranglers.se/playbook/mobile-apps/store-review-and-listing)