Ratings and reviews: how to ask, reply and read them on both stores
The stars next to your app's name are a part of the listing you can't write yourself. This guide covers both stores: how to ask for a rating within the rules, what the rating people see is made of, how to reply to reviews, and how to find the complaint that repeats.
Store facts checked against 23 Apple and Google pages on · See the sources · How we check facts
In short
- Prompt only with each store's own prompt (a link to the store page is fine): RequestReviewAction or AppStore.requestReview(in:) on the App Store, the In-App Review API on Google Play. Neither store promises to show it.
- Never filter who gets asked. Apple's guidelines name filtered feedback, and Google says to ask no question before or while the prompt shows.
- Both stores show a rating by country (on Play, for phones). Google Play currently weights it toward recent ratings; the App Store lets you reset it with a new version, in every country at once.
- Reply first to low-star reviews about the current version. When the fix ships, say so in the release notes and in your replies.
- Read reviews by version and country, label each with one complaint, and count. A before-and-after read of the rating says what followed a fix, not why.
What the rating people see is made of#
Apple shows the summary rating on the product page and in search results, and says ratings and reviews can influence how your app ranks in App Store search. Google ranks apps on a combination of ratings, reviews, downloads and other factors. Neither store publishes the weights.
| Question | App Store | Google Play |
|---|---|---|
| Whose ratings count | One overview rating per country or region. A rating counts in the country where the customer first bought the app (Apple) | Google announced in 2021 that phones would show ratings from the user's registered country, and in 2022 that the default rating would be the user's device type's, where that applies |
| How time is weighed | Apple says iOS 11 and later show an overview rating based on all ratings after Sept 19, 2017, and describes no weighting toward recent ones. Its answer to an outdated rating is the reset | Currently weighted towards more recent ratings, which Google says is there to reflect the changes and updates you make to the app |
| A new version | You may reset the rating when you release one (see below) | No reset. Google says app ratings don't start over when you publish a new version |
| Delay | Apple doesn't state one for ratings | New ratings and reviews are generally held back for around 24 hours. If Google detects suspicious activity in that time, all new ratings and reviews for your app are held back while it investigates |
| Summaries of reviews | An LLM-written review summary on the product page when there are enough reviews, in the United States and 8 more English-language storefronts | Representative summaries in English may show on the listing |
So read the rating per country: a bug that hits one country shows mostly there. A bad version fades from the Play rating as new ratings arrive; on the App Store, your lever is the reset. The ratings page has the short version.
Asking for a rating on the App Store#
Use the system prompt. In SwiftUI, read the requestReview environment value to get a RequestReviewAction and call it. In UIKit, call AppStore.requestReview(in:) with the window scene; StoreKit lists both under requesting reviews. Both need iOS 16 or later, so an app that supports older versions still calls SKStoreReviewController on them. That class is deprecated from iOS 18, though Apple's own ratings page still names it.
Calling it is a request: App Store policy governs whether the prompt appears. StoreKit's rules:
- A person who hasn't rated or reviewed the app on this device sees the prompt at most three times in a 365-day period.
- A person who has rated or reviewed on this device sees it again only for a new app version, and only once more than 365 days have passed since their last review.
- People can also opt out of these prompts for every app they have installed.
Because the prompt may not appear, Apple says not to call it from a button tap or other user action. For a "Rate this app" item in Settings, link to your product page with the query parameter action=write-review, which opens the review page.
Apple's Human Interface Guidelines recommend: ask only after people have shown engagement, such as finishing a level or a significant task; not on first launch or during onboarding; at a natural break, not mid-task; and consider allowing at least a week or two between requests. Apple's sample code asks only once per app version, after a task has been completed at least four times, and after a pause on the completion screen. Apple calls the four arbitrary; choose your own.
NoteA development build always shows the prompt; in a TestFlight build the call does nothing. Neither tells you how often real users see it.
Asking for a rating on Google Play#
Google's In-App Review API shows a card inside your app with 1 to 5 stars and an optional comment. Google enforces a time-bound quota on how often a user can see it, doesn't publish the value, and says it can change without any notice. One hint: calling launchReviewFlow more than once in less than a month might not always show a dialog. Google's rules:
- Ask after a user has experienced enough of the app or game to give useful feedback, and don't prompt excessively.
- Show the card as it is: no change to its size, opacity or shape, no overlay on or around it, on the topmost layer, and never removed by your code.
- No button that triggers the API: the user may have hit the quota and see nothing. Point buttons at your Play Store listing.
- No questions before the card, as below.
Your app shouldn't ask the user any questions before or while presenting the rating button or card, including questions about their opinion (such as "Do you like the app?") or predictive questions (such as "Would you rate this app 5 stars").
The API doesn't report the outcome. Google's integration guide says it does not indicate whether the user reviewed, or even whether the dialog was shown, so your app carries on either way, error or not. The ReviewInfo object it needs is valid only for a limited time: request it ahead, but only once you're sure you will show the card.
To test it, use the internal test track, where the quota isn't enforced. The tester's account must be the primary account in the Play Store, have the app in its library and not have reviewed it yet; a protected account, such as an enterprise one, can't review. With internal app sharing the submit button is disabled. FakeReviewManager fakes the API's results for automated tests and shows no card. The rest of the Android listing is in Google Play ASO.
What both stores forbid#
Use the provided API to prompt users to review your app; this functionality allows customers to provide an App Store rating and review without the inconvenience of leaving your app, and we will disallow custom review prompts.
That is guideline 5.6.1, so a star screen of your own is out on the App Store. Guideline 3.2.2(x) adds that an app must not force people to rate or review it to reach its features or content. And the guidelines' section on business says:
If we find that you have attempted to manipulate reviews, inflate your chart rankings with paid, incentivized, filtered, or fake feedback, or engage with third-party services to do so on your behalf, we will take steps to preserve the integrity of the App Store, which may include expelling you from the Apple Developer Program.
Note "filtered". Apple doesn't define it, but a "Do you like the app?" screen that sends only the yes answers to the rating prompt is the plainest case of it, and Google's API guidance rules out the same question in so many words.
Google Play's ratings policy prohibits inflating ratings, reviews or installs by illegitimate means, including incentivized ratings and reviews. Its first example is a notification offering a discount in exchange for a high rating. Its don'ts add deceptive pop-ups, forced ratings and automated services.
What stays allowed:
- A Rate or Review link in Settings that opens the store page.
- A support link that is always there. Apple asks you to make support contact easy to find in the app and on the product page, so people with a problem can reach you before they write a review. A link anyone can use is not a filter; a question that decides who sees the prompt is.
- Your rating in marketing: Apple allows it if it matches your current rating. Quoting a review needs the reviewer's permission.
Resetting the App Store rating#
You can reset the App Store overview rating when you release a new version. In App Store Connect, open the version and, in the Reset Overview Rating section, select "Reset rating when this version is released". It needs the Admin or App Manager role. Apple's help page holds the details that trip people up:
- It resets every country and region at once.
- Once the version is released, the old rating can't be restored.
- Written reviews stay on the page.
- Until enough people rate the new version, the page says the rating was recently reset. Apple doesn't say how many ratings "enough" is.
- For a universal app, it resets only the platform you chose. App bundles can't be reset.
Apple recommends using it sparingly: the reset rating reflects the current version, but having few ratings may discourage people from downloading. Google Play has no reset.
A decision rule: reset only when three things hold. The low ratings are about a problem this version fixes. That problem shows in the rating in your main countries, not just one, since the reset clears all of them. And new ratings arrive often enough to rebuild a summary within weeks. If any one is missing, keep the rating and fix the problem.
Replying to reviews#
| Question | App Store | Google Play |
|---|---|---|
| Who can reply | Account Holder, Admin or Customer Support role (Apple) | Anyone with the "Reply to reviews" permission (Google) |
| Which reviews | All reviews of your app, regardless of when they were written | Each user review in Play Console. The API reaches only the last week's reviews, and only for production versions |
| Replies per review | One response shows. You can edit or delete it | One public reply. You can edit it |
| When it appears | Up to 24 hours; pending in App Store Connect until then | Google doesn't say. You can reply to a new review before the review itself is public |
| Is the reviewer told | Yes, and they can update their review. Several quick edits send one notification | Yes, by push and email. Through the API, only your first reply to a new or changed review notifies |
| Length | Not stated in Apple's help or API pages | At most 350 characters through the Reply to Reviews API |
| API | Customer reviews and responses in the App Store Connect API | Only reviews with a comment. 200 reads an hour and 2,000 replies a day per app |
| Rules | Guideline 5.6.1: respectful, on the user's point, no personal information, spam or marketing | Google's comment policy: relevant, polite, no solicitation or promotion, and no request for a higher rating |
If you can't answer everything, Apple suggests starting with the lowest star ratings and reviews that mention technical issues with the current version. Name the specific point and what you're doing about it. When an update fixes a problem older reviews named, put it in the release notes and reply to those reviews to say so.
Two exceptions on the App Store: in your reply, point reviewers with download or billing problems to Apple Support, and use Report a Concern for offensive or spam reviews instead of replying (the reviewer isn't told). Apple can also email you when someone edits a review you answered. On Play, Google discourages automated replies you plan to rewrite later: through the API only the first reply notifies, so a placeholder spends it.
Does a reply move the rating? Play Console's Updated ratings section shows how returning reviewers changed their rating, split by whether they got a reply. Google's Play business page says responding to a negative review "can increase that rating by an average of +0.7". It doesn't say how, when or across which apps that was measured (the line has been on the page since at least 2021), or whether the average counts only reviewers who came back to edit: treat it as Google's figure, not a forecast.
Reading reviews: by version, by country, by complaint#
In App Store Connect, Ratings and Reviews lets you pick a country or region from the menu at the top left, and filters reviews by version, by star rating, and by whether a review was edited or answered. The App Store Connect API lists reviews per app or per version, filtered by territory and rating.
Play Console's Reviews page filters by date, language, reply state, star rating, app version and device, has a search box, and translates reviews into your Console language. The Ratings page splits the rating by country, language, app version, Android version, device type, device model and operator, against your peers' median. Reviews analysis adds theme summaries and benchmark topics such as stability and speed, for English reviews only.
A rating doesn't need a written review. On Play, the Ratings page counts stars by version and country, but the Reply to Reviews API returns only reviews with a comment. On the App Store, tvOS apps can be rated but not reviewed. So on Play, when a version's stars drop and its reviews are few, read the rating breakdown before the text.
- Pick the current version and a fixed window, such as the 14 days since its release.
- Filter to 1- and 2-star reviews, one store at a time, in your main countries.
- Give each review one label for its main complaint: a crash, sign-in, the paywall, a missing feature. Reuse the labels week to week.
- Count the labels. One that tops the count on this version and not on the last is your candidate.
- On Play, check it against the stars. If the version's share of 1- and 2-star ratings rose while that label grew, both point the same way.
A weekly routine, with a worked example#
Once a week per app, as part of the loop in how to do ASO:
- Write down the ratings with dates: on Google Play, per main country and for the current version; on the App Store, the overview rating per main country.
- Read and label the new 1- and 2-star reviews.
- Reply to the low-star reviews about the current version first.
- Log each time your code asks for a rating, so you know at least how often you asked.
- When a fix ships, note the day it went live, name the fix in the release notes, and reply to the reviews that named the problem.
| Read | Version 3.3 | Version 3.4 |
|---|---|---|
| Google Play ratings | 4.3 average from 60 | 3.2 average from 50 |
| 1- and 2-star reviews on Play | 8 | 22 |
| Top label on Play | Paywall (3) | Reminders not firing (12) |
| 1- and 2-star reviews, App Store, US | 4 | 9, of which 5 name reminders |
The reminders complaint repeats on both stores and is new with 3.4, so it is what to fix. Version 3.4.1 ships with "Fixed: reminders that stopped firing in 3.4" in the release notes, and the 17 reviews that named it get a reply saying which version fixes it. No App Store reset: the problem lasted two weeks, and a reset would clear the rating in every country.
Fourteen days later, the note reads: "3.4.1 averaged 4.2 from 40 Play ratings in its first 14 days, against 3.2 from 50 for 3.4. Before and after, not a controlled test." At 40 ratings the average is fragile: four more 1-star ratings would take it to about 3.9.
Where RocketASO fits#
RocketASO reads your App Store and Google Play reports, names the fix estimated to be worth most this week, and compares installs before and after it, at 7 and 14 days. Each read is a before-and-after read, not a controlled test. It covers reviews and ratings too. It starts you with a draft of the copy or the keyword field, and nothing reaches the store until you approve it. To see where a listing stands first, run the free ASO audit.
Questions
Can I ask only happy users to rate the app?
No. Google's In-App Review guidance says not to ask any question, such as "Do you like the app?", before or while showing the prompt, and Apple's guidelines list filtered feedback among the ways of manipulating reviews. Ask at the same kind of moment for everyone, and keep a support link where anyone can find it.
Why didn't the rating prompt appear?
Because the store decides. On the App Store, a person who hasn't rated sees it at most three times in 365 days on that device, can turn prompts off, and never sees it in a TestFlight build. On Google Play, an unpublished quota limits it, and Google lists an account that already reviewed the app among the reasons it doesn't show. Google's API doesn't tell your app whether it appeared.
Should I reset my App Store rating after a bad release?
Only if the new version fixes what the low ratings were about, the problem shows in your main countries, and new ratings arrive steadily. A reset clears the rating in every country at once and can't be undone after release, and Apple recommends using it sparingly.
Do replies to reviews change the rating?
Not by themselves: only the reviewer can change a rating. Both stores tell the reviewer about your reply, so they can update it. Play Console's Updated ratings section shows how returning reviewers changed their rating with and without a reply, which is a comparison of groups, not a controlled test.
Sources
23 official pages, all checked . Each says what the page supports.
Apple (13)
- Apple: Ratings, reviews and responses: The summary rating is per territory and can be reset when you release a new version, which Apple recommends doing sparingly.
- Apple: App Store search: Search weighs text relevance (title, subtitle, keywords, primary category) and user behavior such as downloads and ratings; promotional text doesn't affect search ranking.
- App Store Connect Help: Ratings and reviews overview: One overview rating per country or region, where the customer first bought the app; a new rating replaces the old; quick edits to a response send one notification.
- Apple Developer Documentation: RequestReviewAction: The system shows the rating request at most three times in a 365-day period to a person who has not rated the app on that device.
- Apple Developer Documentation: AppStore: StoreKit lists RequestReviewAction and AppStore.requestReview(in:) under requesting reviews.
- Apple Developer Documentation: SKStoreReviewController: SKStoreReviewController, available from iOS 10.3, is deprecated from iOS 18 and macOS 15; use RequestReviewAction instead.
- Human Interface Guidelines: Ratings and reviews: Ask after engagement, not on first launch or in onboarding, at a natural break, with a week or two between requests; people can opt out of prompts for all apps.
- Apple Developer Documentation: Requesting App Store reviews: Apple's sample asks once per app version, after a task is completed at least four times (an arbitrary count) and a short pause.
- Apple: App Review Guidelines: Guideline 5.6.1 requires the provided API and disallows custom review prompts; section 3 names paid, incentivized, filtered or fake feedback; 3.2.2(x) bars forcing a rating.
- App Store Connect Help: Reset an app overview rating: A reset is set on a version, applies in every country at once, can't be undone after release, keeps written reviews, and needs Admin or App Manager.
- App Store Connect Help: Respond to reviews: One response per review, editable and deletable, pending for up to 24 hours; Account Holder, Admin or Customer Support role.
- App Store Connect API: Customer Reviews: The API lists reviews per app or per app version, filtered by territory and rating, with or without published responses.
- App Store Connect Help: View ratings and reviews: Pick a country or region; filter reviews by version, rating, and edited or responded; iOS 11 and later show an overview rating from all ratings after Sept 19, 2017; tvOS apps can only be rated.
Google (10)
- Play Console Help: Get discovered on Google Play search: The text in a store listing helps users discover the app; use SEO best practices in the description within the spam policies; apps are ranked on ratings, reviews, downloads and other factors.
- Android Developers Blog: Making Ratings and Reviews better for users and developers (August 2021): From November 2021, users on phones see ratings from users in their registered country or region.
- Android Developers Blog: Helping Users Discover Quality Apps on Large Screens (March 2022): Where applicable, the default rating shown on Play is that of the device type the user is using.
- Play Console Help: View and analyze your app's ratings and reviews: The rating users see on Google Play is weighted towards more recent ratings.
- Android Developers: Google Play In-App Reviews API: Google Play applies a time-bound quota to the review dialog and does not publish its value.
- Android Developers: Integrate in-app reviews (Kotlin or Java): The API does not say whether the user reviewed or the dialog showed; ReviewInfo is valid for a limited time; continue the app's flow either way.
- Android Developers: Test in-app reviews: Internal test track (quota not enforced), internal app sharing (reviews can't be submitted), FakeReviewManager (no UI), and why the dialog may not show.
- Play Console Help: User Ratings, Reviews, and Installs: Incentivized ratings and reviews are prohibited, with a discount for a high rating as an example; no deceptive pop-ups or forced ratings; replies must not ask for a higher rating.
- Google Play Developer API: Reply to Reviews: Replies of at most 350 characters; production versions only; only reviews with comments from the last week; only the first reply notifies; 200 reads an hour and 2,000 replies a day.
- Google Play business site: Ratings: Google's statement, with no method, period or population given, that responding to a negative review can increase that rating by an average of +0.7.