Key takeaways
- Ask with Apple's built-in review prompt. Apple's guidelines say custom review prompts are not allowed.
- The system shows the prompt to a person at most three times in 365 days, and it decides when. So pick your moments with care.
- Ask right after a win, like a task done or a goal hit. Never ask on first launch or in the middle of a task.
- Add a "Write a review" link in your settings. Add action=write-review to your App Store link to open the review screen.
- Never pay or reward people for reviews, and never lock features behind a rating. Apple bans both.
More ratings help in two ways. They make your star score more stable, and they tell shoppers that real people use your app. The good news is that you don't need tricks. You need the right prompt, at the right moment, in an app worth rating.
This guide covers how Apple's review prompt works, when to ask, and what Apple does not allow.
How do you ask for App Store reviews in your app?
Use Apple's built-in review request. It shows a small system pop-up where people can tap a star rating and write a review without leaving your app. Apple's guidelines say you must use this API, and that custom review prompts are not allowed.
In SwiftUI, read the requestReview value from the environment and call it:
import StoreKit
import SwiftUI
struct WorkoutSavedView: View {
@Environment(\.requestReview) private var requestReview
let workoutsLogged: Int
var body: some View {
Text("Workout saved!")
.task {
// Ask after a real win, and only once the person is a regular.
if workoutsLogged >= 5 {
try? await Task.sleep(for: .seconds(1))
requestReview()
}
}
}
}
In UIKit, older code calls SKStoreReviewController.requestReview(in:). Apple has deprecated that call in favor of newer StoreKit APIs such as AppStore.requestReview(in:). Check Apple's docs for the version you target.
Don't tie the prompt to a button
Apple says the request may not show anything, so don't call it right when someone taps a "Rate us" button. If you want a button, link to your App Store page instead (see below).
How often can you ask for a review?
The system shows the prompt at most three times in 365 days for each person. Apple's rules work like this:
- If the person hasn't rated your app on this device, the prompt can show up to three times in a 365-day period.
- If they have rated it, it can show again only for a new app version, and only if more than 365 days have passed since their last review.
You can call the API more often than that. The system simply decides whether to show it. That means each prompt is precious. Don't waste it on a bad moment.
When testing, keep two things in mind. In a development build, the prompt always shows. In a TestFlight build, it never shows.
When is the best time to ask for a rating?
Ask right after the person gets value from your app. Apple's advice is to ask when people are likely to feel happy, such as after they finish a task or a level. Don't interrupt them.
Good moments look like this:
| App type | A good moment to ask |
|---|---|
| Fitness | Right after a workout is saved |
| To-do or notes | After someone checks off a list or saves a note |
| Photo or video | After an export or share finishes |
| Game | After a level is won, not lost |
| Finance | After a budget goal is met |
| Learning | After a lesson streak is kept |
Bad moments are just as clear:
- On first launch, or during onboarding. They haven't seen any value yet.
- In the middle of a task. You break their flow.
- Right after an error, a crash or a failed payment.
- Right after a paywall or a price screen.
You can also add a simple rule of your own. For example, only ask after the person has used the app on a few different days and just finished a key action. That way, you ask people who already like the app.
Should you ask "Do you like the app?" first?
Be careful here. Some apps show their own "Enjoying the app? Yes / No" screen first. Then they send only the happy people to the real prompt. Apple bans custom review prompts. Its rules also warn against "filtered" feedback. A screen that sends only happy users to the prompt can look like filtering.
The safe path is simple:
- Use the system prompt on its own, at a good moment.
- Give everyone an easy way to send you feedback in the app, such as a "Send feedback" item in settings.
Apple also suggests making your support contact easy to find. It says this gives you a chance to fix bad experiences that might otherwise turn into poor reviews.
How do you make it easy to leave a review any time?
Add a "Write a review" link in your app's settings screen. Apple says you can add action=write-review to your App Store link. It opens the screen where people write a review.
https://apps.apple.com/app/id1234567890?action=write-review
Swap in your own app ID. You can use the same link in your release notes, your newsletter or your help docs. Just never offer anything in return for a review.
What does Apple not allow?
Apple is strict about reviews. Breaking these rules can get your app removed, or even get you removed from the Apple Developer Program.
Apple's rule
Apple's App Review Guidelines say to "use the provided API to prompt users to review your app," and that Apple "will disallow custom review prompts." They also ban manipulating reviews "with paid, incentivized, filtered, or fake feedback."
In plain words, don't do any of these:
- Pay for reviews, or buy them from a service.
- Reward reviews with coins, extra lives, discounts or premium days.
- Force a review. Apps must not make people rate or review to use a feature.
- Write fake reviews, or ask friends to post reviews that aren't honest.
- Build your own rating pop-up that looks like Apple's.
What else brings in more good reviews?
The best way to get good reviews is to fix what people complain about. Then tell them.
- Find the top complaints. Read your 1- and 2-star reviews, or run a free App Teardown on your app to see the main themes.
- Fix the biggest one. One fixed bug can stop a stream of bad reviews.
- Reply to old reviews about it. Apple tells the reviewer when you reply, and they can update their review. Our reply templates make this quick.
- Ship often. A new version gives past raters a fresh chance to see the prompt once a year has passed.
How do you know if it's working?
Watch your rating count and your recent average, not just your all-time stars. Check them each week, and after each release. If you change when you ask, compare the weeks before and after.
To see how many 5-star ratings you need to reach a goal, try our free app rating calculator. To see how your app stacks up against a rival, compare two apps side by side.
Frequently asked questions
How many times can I show the App Store review prompt?
If a person hasn't rated your app on that device, the system shows the prompt at most three times in a 365-day period. You can call the API more often, but the system decides if the prompt appears.
Can I give users a reward for leaving a review?
No. Apple's rules forbid paid, rewarded or fake reviews. Apps also can't force people to rate or review the app to use a feature.
Why doesn't the review prompt show up when I test it?
In development builds, the prompt always shows. In TestFlight builds, it never shows. In the live app, the system decides, and it may skip the prompt if the person has seen it enough.
Can I link straight to the review page?
Yes. Add action=write-review to the end of your App Store product page link. It opens the page where people can write a review.
Should I reset my rating to get more reviews?
A reset clears your summary rating, not your reviews. It does not bring in new reviews by itself. It can make sense after a big fix. See App Store ratings explained.
Sources
Terms in this guide
Written by the Synthiya team. Last updated . See something wrong or out of date? Tell us and we'll fix it.