Files
antigravity-skills-reference/skills/hig-patterns/references/ratings-and-reviews.md

4.7 KiB
Raw Blame History

title: "Ratings and reviews | Apple Developer Documentation" source: https://developer.apple.com/design/human-interface-guidelines/ratings-and-reviews # Ratings and reviews People often view the ratings and reviews for an app or game before they download it. A sketch of a half-filled star, suggesting a favorability rating. The image is overlaid with rectangular and circular grid lines and is tinted orange to subtly reflect the orange in the original six-color Apple logo. Delivering a great overall experience is the best way to encourage positive ratings and reviews, but its also crucial to choose the right time to ask people for feedback. Although every app is different, some possible ways to do this involve looking at how many times or how frequently people launch your app, the number of features someone explores, or the number of tasks they complete. People can always rate your app within the App Store. ## Best practices Ask for a rating only after people have demonstrated engagement with your app or game. For example, you might prompt people when they complete a game level or a significant task. Avoid asking for a rating on first launch or during onboarding, because people havent had enough time to gain a clear understanding of your apps value or form an opinion. People may even be more likely to leave negative feedback if they feel an app is asking for a rating before they get a chance to use it. An illustration of the UI that appears when a person is prompted to rate an app or game in macOS. Avoid interrupting people while theyre performing a task or playing a game. Asking for feedback can disrupt the user experience and feel like a burden. Look for natural breaks or stopping points in your app or game where a rating request is less likely to be bothersome. Avoid pestering people. Repeated rating requests can be irritating, and may even negatively influence peoples opinion of your app. Consider allowing at least a week or two between requests, prompting again after people demonstrate additional engagement with your experience. Prefer the system-provided prompt. iOS, iPadOS, and macOS offer a consistent, nonintrusive way for apps and games to request ratings and reviews. When you identify places in your experience where it makes sense to ask for feedback, the system checks for previous feedback and — if there isnt any — displays an in-app prompt that asks for a rating and an optional written review. People can supply feedback or dismiss the prompt with a single tap or click; they can also opt out of receiving these prompts for all apps they have installed. The system automatically limits the display of the prompt to three occurrences per app within a 365-day period. For developer guidance, see RequestReviewAction. Weigh the benefits of resetting your summary rating against the potential disadvantage of showing fewer ratings. When you release a new version of your app or game, you can reset the summary of individual ratings you received since the last reset. Although resetting means that the ratings reflect the current version, it also tends to result in having fewer ratings overall, which can discourage some people from downloading your app. For developer guidance, see Reset app summary rating. ## Platform considerations No additional considerations for iOS, iPadOS, macOS, tvOS, visionOS, or watchOS. ## Resources #### Related Ratings, reviews, and responses #### Developer documentation RequestReviewAction — StoreKit ## Change log Date| Changes
---|---
September 12, 2023| Added artwork.