App Store Connect Help

Support / App Store Connect / Reference / Achievements

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.