App Store Connect Help
Add platforms
You can add platforms to an app to create a universal purchase to let customers access your app and in‑app purchases across multiple platforms with a single purchase. For example, you can include the macOS, tvOS, and visionOS versions of your app within an existing iOS app. This distribution model lets customers obtain the iOS, macOS, tvOS, and visionOS together.
Similar to creating a new version, a macOS, tvOS, visionOS app, or any combination of creating these platforms, uses the same Apple ID (an app identifier), SKU, and bundle ID as the iOS app.
iPhone and iPad. To offer your app on iPhone and iPad, your app needs to support both devices.
Apple Watch. To offer your app on iPhone and Apple Watch, create an iOS app in Xcode that includes a watchOS counterpart. Upload both apps to App Store Connect from the same Xcode project. Watch-only apps can’t be part of a universal purchase. Learn how to add watchOS app information.
Mac Catalyst. Apps built with Mac Catalyst using Xcode 11.4 or later can share a bundle ID with the iOS version of the app, supporting universal purchase. You can’t add additional platform versions to apps built with Mac Catalyst using Xcode 11.3 or earlier on the Mac App Store.
Apple Vision Pro. You can't make apps that have been in the Kids category available on visionOS.
Multiple app records. If your app is currently available on multiple platforms through separate app records, note that you can't merge them. To offer universal purchase, remove all but one version from sale, and add the other versions to the remaining app's record. Once you remove an app from sale, you make its original product page on the App Store unavailable, you're no longer able to provide updates to existing users. Ratings and reviews are not transferred to the new product page.
When adding macOS, tvOS, visionOS, or any combination of these platforms, you must upload the builds for macOS, tvOS, and visionOS from a separate Xcode target. In the Xcode project, set the bundle IDs to match the iOS app's bundle ID. However, the apps for macOS, tvOS, and visionOS may each have different version numbers and build strings than the iOS app.
Note: Once App Store Review approves at least two platform versions, your app becomes available as a universal purchase. Once it’s a universal purchase, your app stays as universal purchase—not being able to remove a single platform version from the app record.
Learn about adding a platform using App Store Connect API.
Required role: Account Holder, Admin, or App Manager. View role permissions.
-
In Apps, select the app you want to view.
-
In the sidebar, click Add Platform.
-
In the Add Platform dialog that appears, choose the platform you want to add, then click Add.
A version for the platform appears selected in the sidebar with the version number 1.0. You can change the version number in the Version section in the sidebar under App Information.
-
Review and enter metadata for the new platform version.
When you add a platform, metadata from the existing platform version is transferred to the new one, except for the promotional text, description, and screenshots.
Learn more about the platform version information and its required, localizable, and editable properties.
The Account Holder or an administrator can delete a platform if a build has never been uploaded for the specified platform and at least one existing platform version is in an editable app status. To delete a platform, hold the pointer over the platform you want to delete, and then click the delete button (–), which will appear to the right of the platform.