Articles · How-To GuidesUpdated October 2026

A leaderboard is Game Center, Play Games Services, or a table you own.

To add a leaderboard you pick one of three places for the scores to live: Apple's Game Center, Google's Play Games Services, or a table in a backend you control. The first two are free, they come with a player identity and a ready-made screen, and they are built around games. Google's own setup guide tells you to create the app in Play Console and specify that it is a game before any of the leaderboard screens appear. Apple is looser: nothing in its documentation ties Game Center to the Games category, and its own entitlement page talks about users of the app. Every platform claim below comes from Apple or Google documentation read on 23 October 2026. If the app itself does not exist yet, start with make an app.

What follows is what Apple actually publishes about leaderboards, including the limits and the two settings you can never change again, what Google wants from you before a single score posts, and how to decide when the right answer is one table and one list screen.

Start here

The short version

Two reviewed services and one table, and the gap is about who signs in.

The ranking is the cheap part of a leaderboard. A sorted query does it. What the platform services give you is the expensive part: an account that identifies the same person on their other device, a friends list you did not have to build, and a screen you did not have to design. What they take in return is the schedule. A Game Center leaderboard is reviewed by App Review before players can see it, and a Play Games Services leaderboard only reaches the public once you have published the service settings separately from the app.

So the decision is usually settled by two questions. Is the app a game, in the sense that Play Console will let you register it as one. And do the iOS and Android players need to see each other. If the answer to the second one is yes, no platform service helps, because Game Center ranks Apple accounts and Play Games Services ranks Google ones, and there is no bridge between them.

What does Apple document about Game Center leaderboards?

More than most people expect, and the detail that matters sits in the App Store Connect help pages, not in the framework reference. Apple has two kinds of board. A classic leaderboard never resets unless you delete it. A recurring leaderboard resets on a schedule you set, and each run of it is called an occurrence. The App Store Connect help page for leaderboards puts hard numbers on the schedule: the minimum recurrence is five minutes, the maximum is 30 days, and occurrences are not allowed to overlap. GameKit adds that it keeps expired occurrences for up to 30 days, and that a player can see scores only on the current occurrence and one previous one.

The counts are generous. Up to 100 leaderboards per app with no leaderboard sets. Up to 500 in total once you use sets, with a maximum of 100 sets per app and 100 boards inside a set. Two settings in that configuration are worth reading twice before you save. The leaderboard ID is permanent and cannot be edited later, and it is the string your code passes when it submits a score. The score range is optional, but if you ever narrow it, every score outside the new range is lost and cannot be recovered.

The step people do not plan for is review. New or modified leaderboards, leaderboard sets, achievements, challenges and activities must be reviewed before players can see them. The first set rides along with an app version submission, which is the process in publish to app store. After that you can submit components on their own, up to 200 in one submission, and they are reviewed against the latest platform version you pick. There is one more trap in the testing stage. Apple runs all prerelease Game Center development in the same server environment as released games, so a tester's score on an unreleased board is visible to that tester's friends, and so is the fact that they played an unreleased game.

Apple, App Store Connect Help, Manage leaderboards, read 23 October 2026

Check yours

What your leaderboard needs, and what each platform calls it

Tick what the board has to do. Every answer is a setting or a limit that Apple or Google publishes, read on 23 October 2026. Nothing here is a guess about how either service behaves.

Nothing ticked. If the only thing you need is a top ten that never resets, both services do that out of the box and so does a single sorted query against your own table.

Which app types may use Game Center?

Apple does not say, and the pages where such a rule would live do not carry one. The App Store Review Guidelines, last updated 16 October 2026, mention Game Center once, in guideline 2.5.3, and that clause is about apps transmitting code that harms the operating system. No guideline attaches Game Center to a category. The help page for enabling it at the version level opens by saying that apps offering Game Center features need the Game Center entitlement in the entitlements plist and the features configured in App Store Connect before they can be submitted for review. It says apps. The entitlement page itself describes a Boolean that indicates whether users of the app may see and compare achievements on a leaderboard, invite friends and start multiplayer games.

Set against that, every other sentence Apple writes about Game Center says your game. The overview calls it a social gaming network that boosts the discovery of your games. The design guidance is filed under Game Center and talks about gameplay, dungeon runs and racing laps. So if you are building a fitness app or a learning app, here is the useful way to hold it: no published rule blocks you and no published rule covers you either. The one hard requirement Apple does state is mechanical, and it has nothing to do with the category. To add a game with Game Center features to a new app bundle it must be Ready for Distribution on at least one App Store storefront, and once a version is approved with Game Center enabled you cannot disable it for that version, only for the next one.

There is a naming rule too, and it gets picked up in a review of your screens, not of your code. Apple's design guidance for Game Center lists the terms to use in your own interface and the ones to avoid. Call them Leaderboards, not Rankings, Scores or Leaders. Call them Achievements, not Awards, Trophies or Medals. Write Game Center, not GameKit or GameCenter. If you present scores in your own interface rather than the system one, that wording is on you, and so is the container: a sheet is the usual answer, which is add bottom sheet.

Apple, App Store Connect Help, Game Center section, read 23 October 2026

Does Google Play have the same thing, and what does it ask for?

It does, and it is called Play Games Services. The leaderboard itself is in some ways nicer than Apple's. You create one board and the Play Games SDK gives you daily, weekly and all-time versions of it with nothing to configure. Daily boards reset at UTC minus 7 all year, and weekly boards reset at midnight between Saturday and Sunday in the same zone. Each board also has a social version, built from people who chose to share their gameplay activity with your app, and a public one. A game can have up to 70 boards. Scores are stored as long integers and formatted on the way out as a number, a time or a currency, which is how 66032 becomes 1:06.03.

The setup is where the cost sits, and almost all of it is console work. Google's own guide walks through it. You need a Play Developer account with permission to manage Play Games Services, and a Google Cloud project with the Play Games Services API switched on. In Play Console you create an app and specify that it is a game, then open Grow users, Play Games Services, Setup and management. Your game needs an OAuth 2.0 client ID, created in Google Cloud and then linked back as a credential, with the SHA-1 fingerprint of the certificate the app is signed with. Google recommends two credentials, one for the release certificate and one for the debug one, under the same package name. The consent screen's final scope list has to include games, games_lite and drive.appdata, none of which need app verification.

Three details in that guide account for most of the hours people lose. While the game is unpublished, testers must be on an allowlist by email address or by release track, or they hit OAuth and 404 errors instead of a leaderboard, and a newly added tester can take a couple of hours. The application ID you put in the Android manifest is only the leading digits of the client ID, typically twelve or more, shown as Project ID at the top of the Configuration page. And at release you publish the Play Games Services settings first and the app second. Do it the other way round and players signing in with non-tester accounts get errors, because the app is asking for settings that are not public yet.

Google, Play Games Services leaderboards, last updated 8 October 2026, read 23 October 2026

The three options, on what each vendor publishes

Read it as a list of jobs rather than a scoreboard. The first row is the one that decides most of these, and the honest cell is the Apple one, because the answer there is that Apple has not written it down.

The jobGame CenterPlay Games ServicesA table you own
Open to an app that is not a gameApple documents no category rule either wayNoYes
Needs approval before players see the boardYesNoNo
Most boards one app can have100, or 500 with leaderboard sets70Your call
Daily and weekly rankings with no extra setupNoYesNo
One ranking shared by iOS and Android playersNoNoYes
Brings its own player identityYes, but Apple says not to use it to authenticateYesNo
You can delete a board after it goes liveNoYesYes
Needs a server you run and pay forNoNoYes

Google, Play Games Services leaderboards and setup guides, read 23 October 2026

When is a leaderboard you build yourself the right answer?

Most of the time, if the app is not a game. Play Console asks you to register the app as a game before Play Games Services exists for it, so a step counter or a flashcard app has no Android half available even if Apple lets the iOS half through. The second common reason is one ranking for everybody. Game Center ranks Apple accounts and Play Games Services ranks Google accounts, so a single table of 200 people on mixed phones cannot be either of them.

There is a practical reason as well. Neither service has an Expo module. Expo's published documentation index at docs.expo.dev/llms.txt lists its pages, and read on 23 October 2026 there is no entry with the word game in it. In a React Native and Expo project that means native code behind a config plugin on both platforms, before you touch either console. A scores table with a server-side check on submission, and a list screen that pages, is usually less work than that and it ships on both stores at once. If that list is where people look up their own history, the row gestures are the same ones in add swipe actions.

Newly is for building that version. You describe the app in plain English and it writes a real React Native and Expo project you own, with two-way GitHub sync, so the leaderboard screen and the query behind it are code you can read and change. It uploads iOS builds to TestFlight, publishes to Google Play internal testing and builds a standalone Android APK. It costs $25 a month and there is no free tier. It does not press submit on the App Store for you, because Apple requires the owner of the content to submit, and that account stays yours.

One last thing worth saying plainly, whichever route you take. A leaderboard changes how people use an app, and not always in the direction you wanted. Both vendors hint at this in their own guidance. Google documents score limits and a call that hides a player you believe has cheated, because scores get faked the week after launch. Apple warns that Game Center is not a single sign-on service and tells you not to authenticate with it, so the account behind a rank is not an account you can build on. If the number being ranked is something a person can inflate at no cost, the board will measure who worked that out first.

Questions people ask about adding a leaderboard

Apple documents no rule either way, which is the honest answer and not a comfortable one. The App Store Review Guidelines, last updated 16 October 2026, name Game Center exactly once, in guideline 2.5.3, and that clause is about transmitting code that harms the operating system. No guideline ties Game Center to the Games category. The App Store Connect Help page Manage an app version for Game Center opens with the line that apps offering Game Center features need the Game Center entitlement in the entitlements plist and the features configured in App Store Connect before they can be submitted for review, and it says apps there, not games. The Game Center Entitlement page describes the key as indicating whether users of the app may see and compare achievements on a leaderboard, invite friends and start multiplayer games. Everywhere else Apple writes your game. So nothing documented stops you, and nothing documented promises you anything either. Read 23 October 2026.

Write down the number you are ranking.

One line: what the score is, who is allowed to see it, and whether it resets. That line decides which of the three options you need, and it is also the brief for the screen.

Start building