CFBundleShortVersionString

CFBundleShortVersionString is a key in an Apple platform application’s Info.plist that specifies the bundle’s release version as presented to users. It is distinct from CFBundleVersion, which records the build number or internal version. The Short Version String is intended for display in user-facing contexts such as the App Store, device settings, and other UI elements, while the build number is for internal tracking and update management.

The value is a string and is commonly formatted using semantic versioning, for example "1.2.3" or "2.0". Apple does not require a strict numeric format, but using a clear major.minor[.patch] scheme is widely adopted because it aligns with user expectations and store processes. When submitting updates, the marketing version (the Short Version String) should reflect an increased release version relative to the previous submission, and the build number (CFBundleVersion) should typically be incremented with every new build.

Setting and maintenance: In Xcode, CFBundleShortVersionString is exposed as the Version field in the project target’s General tab and maps to the corresponding Info.plist key. It can also be set directly in the Info.plist file by including <key>CFBundleShortVersionString</key> and an accompanying string value. Developers should ensure this string matches the intended user-visible version for App Store listings and in-app version displays.

Relation to other keys: CFBundleVersion is the build number and may reset or increment independently of the Short Version String. Together, they provide both a user-facing version and a developer-facing build identifier, supporting release management, diagnostics, and update processes.