A Flutter plugin that lets you show a review pop up where users can leave a review for your app without needing to close your app. Alternatively, you can open your store listing via a deep link.
It uses the In-App Review API on Android and the SKStoreReviewController on iOS/MacOS.
The following code triggers the In-App Review prompt. This should not be used frequently as the underlying API's enforce strict quotas on this feature to provide a great user experience.
import 'package:in_app_review/in_app_review.dart';
final InAppReview inAppReview = InAppReview.instance;
if (await inAppReview.isAvailable()) {
inAppReview.requestReview();
}- Use this after a user has experienced your app for long enough to provide useful feedback, e.g., after the completion of a game level or after a few days.
- Use this sparingly otherwise no pop up will appear.
- Triggering this via a button in your app as it will only work when the quota enforced by the underlying API has not been exceeded. (Android)
- Interrupting the user if they are mid way through a task.
Testing requestReview() on Android isn't as simple as running your app via the emulator or a physical device. See Testing for more info.
The following code opens the Google Play Store on Android, the App Store with a review screen on iOS & MacOS and the Microsoft Store on Windows. Use this if you want to permanently provide a button or other call-to-action to let users leave a review as it isn't restricted by a quota.
import 'package:in_app_review/in_app_review.dart';
final InAppReview inAppReview = InAppReview.instance;
inAppReview.openStoreListing(appStoreId: '...', microsoftStoreId: '...');appStoreId is only required on iOS and MacOS and can be found in App Store Connect under General > App Information > Apple ID.
microsoftStoreId is only required on Windows.
https://developer.android.com/guide/playcore/in-app-review#when-to-request https://developer.android.com/guide/playcore/in-app-review#design-guidelines
Since there is a quota on how many times the pop up can be shown, you should not trigger requestReview() via a button or other call-to-action option. Instead, you can reliably redirect users to your store listing via openStoreListing().
You must upload your app to the Play Store to test requestReview(). An easy way to do this is to build an apk/app bundle and upload it via internal app sharing.
Real reviews cannot be created while testing requestReview() and the submit button is disabled to emphasize this.
More details at https://developer.android.com/guide/playcore/in-app-review/test
requestReview() can be tested via the iOS simulator or on a physical device.
Note that requestReview() has no effect when testing via TestFlight as documented.
Real reviews cannot be created while testing requestReview() and the submit button is disabled to emphasize this.
openStoreListing() can only be tested with a physical device as the iOS simulator does not have the App Store installed.
This plugin can be tested by running your MacOS application locally.
| Function | Android | iOS | MacOS | Windows(UWP) |
|---|---|---|---|---|
isAvailable() |
✅ | ✅ | ✅ | ❌ |
requestReview() |
✅ | ✅ | ✅ | ❌ |
openStoreListing() |
✅ | ✅ | ✅ | ✅ |
Upvote flutter/flutter#14967 if you're interested in Windows support!
Requires Android 5 Lollipop(API 21) or higher and the Google Play Store must be installed.
Requires iOS version 10.3
Requires MacOS version 10.14
Issues & pull requests are more than welcome!