Summary (TL;DR): A guide for app developers: what the Play Console and the reviews API actually give you, why ratings differ by country and device, how the in-app review prompt works, the ways to display Play reviews on a website, and where the rating belongs on an app landing page.

For an app, the rating is the product page. Someone deciding whether to install spends a second on the number and the recent reviews, and rather longer on your website only if the number survived that second.
That makes the store rating one of the few pieces of proof genuinely worth putting on your own site. It is independent, it is current, and unlike a testimonial you collected, it is a number your visitor already knows how to interpret.
Getting it there is less automatic than you would expect. Google Play has no embed you can paste, its API is built for a different job, and the rating itself is not a single number. This guide covers what the Play Console gives you, what the API will and will not do, the display options, and where the proof belongs on an app landing page.
What the Play Console Actually Gives You
Everything starts in the console, and most developers use a fraction of what is there.
- Ratings and reviews, filterable. By star rating, by app version, by device, by country and by language. The version filter is the one that earns its keep, because it turns a vague sense that something got worse into a specific release.
- Replies. Public, attached to the review, visible to everyone who reads it afterwards. This is the highest value thing in the console and the most neglected.
- Rating breakdowns over time. Which tell you whether the average is being dragged by history or by something happening now.
- The ability to report reviews that break policy, which is not the same as reviews you dislike.
Two console habits are worth forming. Read one star reviews weekly, filtered to your current version, since that is where crashes and confusing flows announce themselves before your analytics catch up. And read the country breakdown occasionally, because a market where the rating is a point lower usually means a translation or a payment problem rather than a difference in taste.
Why There Is No Single Rating
This surprises people the first time they see their app rated differently on two phones, and it matters for what you display.
Play calculates ratings by country and by device type, so what a user sees reflects users in their market on similar hardware. The intention is a rating that predicts their experience rather than an average across circumstances that have nothing to do with them. There is also a recency weighting, so a rating reflects what recent users think rather than being anchored by the first year of the app's life.
Three practical consequences:
- The number on your website is a choice. Pick the market your site actually speaks to, and say which one if it matters.
- Improvements show up faster than you expect. Fixing the thing that caused a run of bad ratings moves the visible number sooner than a simple lifetime average would.
- A tablet or older device rating can be much worse than your headline. If your support conversations do not match your average, filter by device before concluding anything.
The Reviews API, and What It Is For
There is a programmatic route to reviews as part of the Play Developer API, and it is worth understanding before building on it.
It is designed for monitoring and replying. You can list recent reviews and post replies, which is what makes support tooling and alerting possible. What it does not do is hand you your full review history: it surfaces a recent window, roughly the last week, which the reviews list reference sets out.
That single limitation shapes everything. A testimonials section built directly on the API will show whatever arrived in the last few days, which is not a selection, it is a sample. If you want your best reviews on your website, you need to be storing them as they come in, which is a five line addition to whatever already polls the API and is obvious only in hindsight.
It also requires a service account with access to your developer account, so it belongs in a backend job rather than anywhere near a browser. For most teams the honest assessment is that the API is worth wiring up for alerts on new one star reviews, and not worth wiring up to render a website section.
Three Ways to Show Play Reviews on a Website
| Reviews widget | Hand written quotes | Your own API pipeline | |
|---|---|---|---|
| Setup | Minutes | An hour | Days |
| Shows the star rating | Yes | If you add it | Yes |
| Stays current | Yes | No | Yes |
| Access to older reviews | Depends | Whatever you saved | Only what you stored |
| Design control | Layout and styling | Total | Total |
| Maintenance | Near zero | You, quarterly | A service to run |
The middle column is underrated for small apps. Four good reviews, quoted with the reviewer's first name and the date, next to a live link to the listing, is honest, fast and costs nothing to serve. Its weakness is entropy: nobody updates it, and a quoted review from two versions ago is a small lie by omission.
Whatever you choose, put the store badge and a working install link beside the reviews. A visitor persuaded by the proof should not then have to search for your app, and losing them at that point is the most avoidable mistake on the page.
The In-App Prompt, Done Properly
Ratings on your website start with ratings in the store, and the in-app review flow is the supported way to ask.
The mechanics are documented in the in-app review API guide, and the rules that matter are behavioural rather than technical:
- Trigger it after success, not on launch. A finished task, a completed order, a level cleared, a file exported. Never during onboarding, and never while someone is trying to do something else.
- Do not pre-screen. Asking "are you enjoying the app" and only showing the rating flow to people who say yes is against the design guidance and it is the reason people distrust these prompts.
- Expect quotas. The flow does not appear every time you call it, by design. Build so that nothing in your app depends on it having been shown.
- Never block anything behind it. A rating prompt that stands between a user and their content produces the rating you deserve for that decision.
- Ask rarely. Once per user per long period. The gain from asking more is small and the cost is a one star review about the prompt.
The uncomfortable truth underneath: prompts move the number a little, and fixing what the bad reviews describe moves it a lot. If a run of two star reviews all mention the same crash, no prompt strategy will outrun it.
Where the Rating Belongs on an App Page
An app landing page has one job, which is the install, and the proof should be arranged around that rather than parked in a section of its own.
- Beside the install button, in miniature. Stars, the average, the number of ratings. This is the highest value placement on the page and it takes one line.
- Under the main screenshot, where a visitor is forming their first impression of what the app looks like.
- Beside a feature that is hard to believe. If the page claims the app works offline, the review saying it worked offline on a flight belongs there.
- Near a price or subscription block, for the same reason it belongs on a software pricing page: that is where doubt concentrates.
- Not as a long carousel. An app page is scanned quickly, and a carousel of twelve reviews is a section people scroll past on their way to the button.
Show the number of ratings alongside the average. Four point five from a large number is proof, and four point nine from eleven ratings tells a reader you have eleven ratings. Hiding the count reads as hiding the count.
Ratings and Reviews Are Not the Same Supply
A distinction worth holding on to, because it explains why your section may have a healthy number and nothing to quote.
Most people who rate an app never write anything. They tap the stars, the flow closes, and that is the whole interaction. Written reviews come from a much smaller group, and that group skews toward the two ends: people delighted enough to say so, and people annoyed enough to type on a phone. The comfortable middle is almost entirely silent.
Two things follow for a website section. Your average is a broad measure and your review text is not, so quoting three reviews is never a summary of what users think, whatever the stars beside them say. And a run of critical written reviews can sit alongside a stable average, because the people who were fine said so with a tap and moved on.
The practical version. Use the average and the count as the headline, because that is the honest aggregate. Use written reviews as illustration, chosen for what they explain rather than for their score. And when the written reviews turn negative while the average holds, treat it as an early warning rather than an anomaly, because the writing usually moves first.
What to Show Before You Have Ratings
A new app has no proof, and the worst response is to display an empty rating block with a lonely number in it. Four honest substitutes work better than a weak number.
- A short video of the app doing the thing. For a new app this outperforms any review, because the visitor's real question is whether it works, not whether strangers liked it.
- Beta feedback, clearly labelled as beta. Quoting a tester by name and role is legitimate as long as you say what it is. Presenting it as a store review is not.
- The problem stated precisely. A visitor who recognises their own problem in your first sentence needs less proof than one who does not.
- A visible support route. A named way to reach a human answers most of the fear that a rating would have answered.
Then get the first ratings the ordinary way: ship something people finish using, trigger the review flow after they finish, and do not touch the rating block on the website until the count is high enough to be worth showing. Roughly speaking, if a visitor can count your ratings at a glance, the number is not helping you yet.
Resist the temptation to fill the gap with invented reviews or a rating you cannot support. It is checkable in one tap, and being caught costs more than the empty space ever did.
Which Reviews to Quote
The store shows the newest and the most helpful. Your website should show something more deliberate.
- Reviews that name the use case. "I use this to track deliveries for a small courier round" tells a visitor whether the app is for them, which is the question they actually have.
- Reviews written after real use. Someone describing week six is more credible than someone delighted on day one.
- Reviews mentioning support. Especially valuable for a paid app, because the fear is being stuck with something that does not work and nobody to ask.
- One review that mentions a limitation. A four star review that says what the app does not do, and buys anyway, does more for credibility than the five star ones around it.
- Not reviews about a version you have replaced. They date the page and can describe an app that no longer exists.
Quote exactly, keep the first name and the date, and never tidy someone's grammar. The unpolished phrasing is the part that reads as real, and editing it is both dishonest and less effective. The general case for why this works is covered in how customer reviews influence purchase decisions.
Replying, and Why It Is Worth the Time
A reply is permanent, public and read by future visitors far more than by the person who wrote the review.
Reply to the specific complaint. Name the problem, say whether it is fixed or being worked on, and give a route to support. Generic apologies signal a template and a team that is not listening.
Update the reply when you ship the fix. This is the move almost nobody makes, and it converts an old complaint into evidence that you fix things.
Do not argue. A reviewer who misunderstood the app is telling you something about your onboarding. The reply that says so gracefully persuades everyone else reading.
Ask them to update the rating, once, after the fix ships, and only where you genuinely solved it. Many people do.
The pattern of what people complain about matters as much as the individual reply, and the effect of that pattern on installs is real. We covered the general shape of it in the impact of positive and negative reviews on conversion.
Store Rules Worth Knowing
Two areas where enthusiasm turns into a policy problem.
Incentives. Offering anything in exchange for a rating, in-app currency included, is against Play's policies. It also produces ratings that tell you nothing, since the person rated the reward rather than the app.
Brand assets. The store badge is Google's trademark and comes with usage rules covering the artwork, spacing and wording. Use the official badge rather than a redrawn one, and do not write your own version of the phrase.
A third, subtler point: do not display a rating on your site that you cannot support. Rounding four point three up to a solid four and a half, or quoting a rating from a market where you happen to do best without saying so, is the kind of small dishonesty that costs a great deal if a visitor checks. They can check in one tap, and the link you provided is what they will use.
Showing Both Stores on One Page
Most apps ship on two platforms, and the landing page then has to represent two ratings that will never agree.
The tidy solution is one compact block per store, side by side, each with its own average, its own count and its own install link. It is honest, it takes one line more than a single rating, and it lets a visitor see the number that applies to the phone in their hand.
What not to do is average the two into a single figure. It is not a number that exists anywhere, nobody can verify it, and the moment a visitor compares it to either store they have caught you rounding. The same applies to showing whichever store rates you better and quietly omitting the other, which readers notice more often than you would hope.
One layout detail. Detect the visitor's platform if you reasonably can, and lead with that store's block and button while keeping the other visible. An Android user meeting an iOS badge first has to do a small piece of work that some of them will not bother with.
Keep the two blocks in the same visual shape, whatever the numbers say. A page that styles the good rating in colour and the other one in grey is making an argument that a reader will decode instantly.
Problems and Their Fixes
- The rating on your site is stale. Hard coded numbers always are. Either display something that updates or diarise a check with every release.
- The average dropped after a release. Filter by version in the console. If the drop starts exactly at a version, you have your cause and probably your crash.
- Reviews mention a feature you never built. Usually confusion with a similarly named app, and occasionally a sign your store listing screenshots are promising something the app does not do.
- The API returns nothing useful. Expected if you are looking for older reviews. It returns a recent window only.
- Your section shows five star reviews and the store shows three. A visitor will notice. Show the real average next to the quotes, or the quotes will do more harm than good.
- The install link goes to the store homepage. Link to the listing itself, and test it on a phone rather than a desktop, since the behaviour differs.
Getting Started
The short path. Take the average, the rating count and four reviews that describe real use, and put the compact version beside your install button rather than in a section of its own. Link every claim to the store listing. Set up the in-app review flow to trigger after a moment of success, and leave it at that. Then read your one star reviews once a week, because they are the cheapest product research you will ever get.
If you would rather not maintain the numbers by hand, a Google Play reviews widget handles the display and the styling, so the rating on your page keeps up with the rating in the store.
If you sell software as well as an app, the same job on a review site works differently: adding Capterra reviews to your website covers the vendor profile and where proof belongs on a pricing page.



