Free beta. ExpertKin is new and still changing, and paying isn't open yet. Send feedback

ExpertKin
Build Apps: Ship Updates Without Breaking Anything

Free preview lesson

Get Ready: Version Numbers and a Safe Starting Point

Understand version and build numbers

Every app update has two numbers, and beginners often mix them up. Knowing the difference saves you from rejected uploads and confusing release notes.

The marketing version is the number users see in the App Store, such as 1.2. It tells people what kind of update they are getting. You can keep the same marketing version for several uploads while you fix problems.

The build number is an internal counter. It is not shown to most users. Each time you upload a build to App Store Connect (Apple's website for managing your app), the build number must be higher than every build you have uploaded before for that version. Apple uses it to tell builds apart.

This is why Apple rejects an upload when the build number has already been used. Even a tiny re-upload of the same number counts as a duplicate.

  1. Look at the version number you plan to publish.
  2. Find the last build number you uploaded.
  3. Make sure your new build number is higher.

A simple habit is to increase the build number by one every time you upload, even for tests. Check the official Apple developer documentation for the current rules, since details can change.

What to do now: write down your current marketing version and the last build number you uploaded.