Reference

Achievements

Achievement metadata identifies each achievement and its behavior in App Store Connect. You can input the language-specific text used in the achievement displays and track the status to determine if the achievement has been approved and made live with the app.

Learn how to configure achievements.

Achievement properties

The main achievement properties in App Store Connect identify each achievement and how they behave.

Properties	Description
Reference Name	An internal name that you must provide for each achievement. This is the name you use if you search for the achievement within App Store Connect.
Achievement ID	A chosen alphanumeric identifier for your achievement. This ID is limited to 100 characters (assumes single-byte characters). Your Achievement ID is a permanent setting and therefore can’t be edited at a later date.
Point Value	The points that your achievement is worth. There is a maximum of 100 points per achievement and a maximum of 1000 points total for all achievements.
Hidden	Achievements marked as Hidden remain hidden in Game Center until a player has achieved them.
Achievable More Than Once	An indication of whether the player can earn the achievement multiple times.

Achievement language properties

Achievement language properties collect language-specific text used in achievement display. You must include these properties for at least one language.

Property	Description
Localization	The language in which you’d like this achievement to appear. There must be at least one language defined.
Display Name	The localized title of this achievement as you’d like it to appear in Game Center.
Earned Description	The description of your achievement as it appears to Game Center users after they earn it.
Pre-earned Description	The description of your achievement as it appears to Game Center users before they earn it.
Image	A localized image that represents the achievement. The image must be a `.jpeg`, `.jpg`, or `.png` file that’s 1024 x 1024 pixels, at least 72 dpi, and in the RGB color space. This property is required.

Achievement statuses

Achievement statuses indicate whether the achievement has been approved and made live with the app.

Property	Description
Live	The achievement was approved with the app.
Not Live	The achievement has not been approved with a version of the app. Achievements will also have this status if they were previously Live for an app, moved to a group, and haven’t been approved with the group yet.