antigravity-skills-reference/skills/hig-components-controls/references/rating-indicators.md

---
title: "Rating indicators | Apple Developer Documentation"
source: https://developer.apple.com/design/human-interface-guidelines/rating-indicators

# Rating indicators

A rating indicator uses a series of horizontally arranged graphical symbols — by default, stars — to communicate a ranking level.

![A stylized representation of a rating indicator denoting a ranking of three out of five stars. The image is tinted red to subtly reflect the red in the original six-color Apple logo.](https://docs-assets.developer.apple.com/published/aacce03e9d1c173b00080802bc79ff5d/components-rating-indicators-intro%402x.png)

A rating indicator doesn’t display partial symbols; it rounds the value to display complete symbols only. Within a rating indicator, symbols are always the same distance apart and don’t expand or shrink to fit the component’s width.

## [Best practices](https://developer.apple.com/design/human-interface-guidelines/rating-indicators#Best-practices)

**Make it easy to change rankings.** When presenting a list of ranked items, let people adjust the rank of individual items inline without navigating to a separate editing screen.

**If you replace the star with a custom symbol, make sure that its purpose is clear.** The star is a very recognizable ranking symbol, and people may not associate other symbols with a rating scale.

## [Platform considerations](https://developer.apple.com/design/human-interface-guidelines/rating-indicators#Platform-considerations)

 _No additional considerations for macOS. Not supported in iOS, iPadOS, tvOS, visionOS, or watchOS._

## [Resources](https://developer.apple.com/design/human-interface-guidelines/rating-indicators#Resources)

#### [Related](https://developer.apple.com/design/human-interface-guidelines/rating-indicators#Related)

[Ratings and reviews](https://developer.apple.com/design/human-interface-guidelines/ratings-and-reviews)

#### [Developer documentation](https://developer.apple.com/design/human-interface-guidelines/rating-indicators#Developer-documentation)

[`NSLevelIndicator.Style.rating`](https://developer.apple.com/documentation/AppKit/NSLevelIndicator/Style/rating) — AppKit

## [Change log](https://developer.apple.com/design/human-interface-guidelines/rating-indicators#Change-log)

Date| Changes  
---|---  
September 23, 2022| New page.