This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

expo-store-review is a library that provides access to ReviewManager API on Android 5+ and SKStoreReviewController API on iOS. It allows you to ask the user to rate your app without leaving the app itself.

Installation

If you are installing this in an existing React Native app, make sure to install expo in your project.

Usage

It is important that you follow the Human Interface Guidelines for iOS and Guidelines for Android when using this API.

Specifically:

• Don't call StoreReview.requestReview() from a button - instead try calling it after the user has finished some signature interaction in the app.
• Don't spam the user.
• Don't request a review when the user is doing something time sensitive like navigating.
• Don't ask the user any questions before or while presenting the rating button or card.

Write reviews

Android

There is no equivalent redirect on Android, you can still open the Play Store to the reviews sections using the query parameter showAllReviews=true like this:

const androidPackageName = 'host.exp.exponent';
// Open the Android Play Store in the browser -> redirects to Play Store on Android
Linking.openURL(
  `https://play.google.com/store/apps/details?id=${androidPackageName}&showAllReviews=true`
);
// Open the Android Play Store directly
Linking.openURL(`market://details?id=${androidPackageName}&showAllReviews=true`);

iOS

You can redirect an app user to the "Write a Review" screen for an app in the iOS App Store by using the query parameter action=write-review. For example:

const itunesItemId = 982107779;
// Open the iOS App Store in the browser -> redirects to App Store on iOS
Linking.openURL(`https://apps.apple.com/app/apple-store/id${itunesItemId}?action=write-review`);
// Open the iOS App Store directly
Linking.openURL(
  `itms-apps://itunes.apple.com/app/viewContentsUserReviews/id${itunesItemId}?action=write-review`
);

API

import * as StoreReview from 'expo-store-review';

No API data file found, sorry!

Error codes

ERR_STORE_REVIEW_FAILED

This error occurs when the store review request was not successful.