# App Store and Google Play reviews

Pull your mobile app's public App Store and Google Play reviews into the Usero feedback inbox, where they cluster alongside the
rest of your feedback and can become AI-authored pull requests. A recurring one-star bug, spread across many reviews under
different wording, clusters into one item you can fix.

Connecting needs nothing from Apple or Google. Public reviews are public, so there is no store account, no API key, and no
review-response permission involved. You paste your store links and the import runs from there.

## What it does

- **Import public reviews from both stores.** Usero fetches the recent public reviews from your App Store listing and your Google
  Play listing and turns each one into a feedback item in your inbox, sitting next to widget, email, GitHub, and Slack feedback.
- **Cluster and classify.** Imported reviews run through the same AI analysis as everything else: duplicates cluster, and each
  review is sorted into a bug, request, or praise bucket.
- **Feed the AI-PR step.** Because reviews land as normal feedback, a clustered bug from your reviews can become a GitHub pull
  request from the cluster, the same way any other feedback item can. See the
  [GitHub integration](/docs/integrations/github) for the PR flow.

## Prerequisites

- A Usero account and a project. Anonymous visitors can browse but cannot connect a store.
- Your app's public App Store page, Google Play page, or both. You can connect just one store.
- Nothing from the store consoles. No App Store Connect access, no Google Play Console access, no API key.

## Connect (paste your store links)

1. Open your project, then go to **Integrations** (the URL is `usero.io/YOUR_CLIENT_ID/integrations`). To open your own
   integrations page, [go here](/integrations).
2. Find the **App reviews** card and open it. The same panel also lives in **Settings**, in the App reviews section
   (the `#app-reviews` anchor).
3. **App Store:** paste your App Store page link, for example `https://apps.apple.com/us/app/your-app/id618783545`. You can also
   paste just the numeric app id (`618783545`). Usero parses the id and the storefront from the link; if you pasted a bare id,
   pick the storefront (country) from the dropdown that appears.
4. **Google Play:** paste your Google Play page link, for example `https://play.google.com/store/apps/details?id=com.your.app`, or
   just the package name (`com.your.app`).
5. You can fill one store or both. Click **Start importing reviews**.

The form validates each field as you type and shows a green check with the parsed app id or package name once it recognises the
link, so you can confirm you pasted the right thing before connecting.

## What happens after connect

Connecting returns right away and the first import runs in the background on a queue. The panel then polls for status and shows
you the run live:

1. **Queued, then fetching.** A per-store row appears (App Store, Google Play) with a count that climbs as reviews come in. Each
   store flips to a check when it finishes.
2. **Analyzing.** Once reviews are imported, the AI reads them and sorts them into bugs, requests, and praise.
3. **The first-import insight.** When the run finishes, the panel shows how many reviews landed, the bug / request / praise
   breakdown, and the single most-mentioned theme across both stores, with a link into the dashboard to act on it.

You can close the panel at any point; the import keeps running in the background. If one store lands reviews and the other cannot
be reached, Usero shows the win and surfaces the failed store as a recoverable note rather than failing the whole import.

## Re-sync cadence

After the first import, Usero rechecks both stores every few hours and new reviews land in your inbox automatically. You do not
have to re-run anything for ongoing reviews.

To pull immediately rather than wait for the next scheduled check, click **Sync now** in the connected panel. Re-syncing is
deduplicated by each review's stable per-store id, so running it again will not create duplicate feedback items.

Imports are capped to a recent, newest-first window and skip star-only and very short reviews, so the inbox fills with reviews you
can act on rather than years of one-line noise.

## Troubleshooting

**The connect button stays greyed out.** You need at least one valid store. Check the field shows a green check with a parsed app
id or package name. A red hint under a field means the link or id was not recognised; paste the full store page link instead of a
search URL.

**"We couldn't finish the import."** A store did not respond on that run. Reviews already in your inbox are unaffected. Usero
retries on the next scheduled check, or you can click **Sync now**. The panel keeps the raw error visible underneath for context.

**One store imported, the other didn't.** Usero leads with the store that landed and shows a calm note for the one that failed,
with a **Recheck that store** action. This is usually a transient fetch issue; rechecking often clears it.

**"Connected. No reviews to import yet."** The store is connected but no review passed the quality filter (or the app has no
public reviews in the window yet). New reviews land automatically as users post them. You can click **Check again** to re-pull.

**A review I expected isn't there.** Star-only reviews and reviews shorter than the minimum length are filtered out on purpose,
and the import keeps a recent window rather than the full history. Very old reviews fall outside that window by design.

## Next

- [Integrations overview](/docs/integrations)
- [GitHub integration (turn a clustered review bug into a PR)](/docs/integrations/github)
- [Find your clientId](/docs/find-your-client-id)