Mac launch · Official sources first
Launch a macOS app on the Mac App Store
A practical Mac App Store launch and ASO guide: choose the right app architecture, add macOS to an existing record, prepare the product page, test, submit, and measure the release.
In brief
For an existing iPhone or iPad app, add macOS to the same App Store Connect record when you want Universal Purchase. Decide the architecture before creating records, ship a desktop-quality product, and give the Mac version its own screenshots, description, testing, and review context.
On this page
Choose the Mac app before you choose the listing
There are three different ways an iPhone or iPad product can reach Mac users. They do not create the same product, distribution path, or store story.
Build for the desktop
Choose this when menus, windows, keyboard work, file behavior, automation, and deep Mac conventions are central to the product.
Bring the iPad foundation
Choose this when the iPad codebase is the right starting point and you can still finish the experience for Mac input, windows, menus, and layout.
Offer compatibility
Apple silicon Macs can run eligible iPhone and iPad apps. This is availability, not a substitute for a deliberately designed Mac product.
Editorial rule: do not call an app “made for Mac” because it launches on a Mac. The store promise should match the interaction model you actually ship.
Add macOS to the existing app record
For a Universal Purchase, open the existing app record in App Store Connect and add macOS as a platform. Apple says the Mac app uses the same Apple ID, SKU, and bundle ID as the iOS app. You upload the Mac build from a separate target, and the platform versions may use different version and build numbers.
Identity
- Shared
- Apple ID, SKU, bundle ID, app record
- Platform delivery
- A separate macOS target and build
Versioning
- Allowed
- Different platform version and build numbers
- Operational advice
- Document the mapping for support and release notes
Initial transfer
- Apple transfers
- Most existing app information
- Prepare for macOS
- Promotional text, description, and screenshots
If an eligible iPhone or iPad app is already offered on Apple silicon Macs, releasing a native macOS platform version replaces that iOS-on-Mac version in the Mac App Store. Existing users receive the Mac app as an update. Test data, files, accounts, and purchase restoration with that transition in mind.
- Apple · Add platforms ↗
- Apple · Universal Purchase ↗
- Apple · iPhone and iPad apps on Apple silicon Macs ↗
Build a Mac product page, not a stretched phone page
A Mac prospect wants evidence about a desktop workflow: what the window contains, how much context stays visible, what keyboard and pointer use feel like, how files or sync behave, and whether the app belongs beside the tools they already use.
Mac screenshots
Apple currently accepts 1–10 Mac screenshots. They must use a 16:10 aspect ratio, contain no transparency, and use one of these exact pixel dimensions:
- 01Lead with the desktop promise
Show the main window at a readable scale and make the outcome clear without relying on tiny UI.
- 02Prove the working surface
Use a real, credible state that reveals navigation, information density, or the canvas.
- 03Show native interaction
Include the Mac value that matters: multiple windows, keyboard flow, menus, drag and drop, files, or pointer precision.
- 04Connect the ecosystem
If it is true, show how the Mac experience continues work from iPhone or iPad without implying functionality you do not ship.
- 05Close on trust
Use the final frame for privacy, offline ownership, purchase continuity, or another concrete decision-making proof.
App previews are optional. Apple allows up to three per supported display size and language; macOS previews must be landscape. A preview should demonstrate interaction that a still image cannot explain—not repeat the screenshot captions with motion.
Mac metadata and ASO
The app name and subtitle are app-level information, while the platform version contains its description, promotional text, keywords, support URL, marketing URL, version details, and creative. Write the Mac description in desktop language: sessions, windows, documents, keyboard flow, and continuity where those claims are real. Avoid presenting the Mac listing as a footnote to the iPhone app.
Choose the Mac primary and secondary categories for genuine product fit. Apple also requires the macOS category selected in App Store Connect to match the category configured in the Xcode project.
Apple App Store
App name
30charactersLocalized and editable only when the app version status permits it.
Official source ↗Apple App Store
Subtitle
30charactersA concise summary shown beneath the app name.
Official source ↗Apple App Store
Promotional text
170charactersConversion copy that can be updated independently of a new version.
Official source ↗Apple App Store
Keywords
100UTF-8 bytesComma-separated terms; Unicode characters can consume more than one byte.
Official source ↗Apple App Store
Description
4000charactersVisible product-page copy. The first sentence should explain the product before the text is expanded.
Official source ↗Apple App Store
What’s New
4000charactersCustomer-facing release notes for the version being submitted.
Official source ↗Prove desktop quality before the store page promises it
App Sandbox is required for Mac App Store distribution. Configure only the entitlements the product needs, then exercise the signed release build against the real file, network, account, purchase, notification, and data paths those entitlements affect.
- 01Test supported Macs
Use real supported hardware where possible, not only a debug build on the primary development machine.
- 02Test window life cycles
Open, resize, minimize, restore, close, relaunch, and use multiple windows if the product supports them.
- 03Test every input path
Keyboard navigation, shortcuts, pointer states, menus, scrolling, focus, drag and drop, and text editing should feel intentional.
- 04Test continuity and migration
Verify sign-in, sync, local files, entitlements, subscription access, and restoration from the existing iOS customer state.
- 05Test accessibility by task
Complete common workflows using the accessibility features you intend to declare for Mac, not merely a component checklist.
- 06Run TestFlight
TestFlight for Mac requires a supported Xcode toolchain. External testing can include up to 10,000 testers; the first external build needs beta review and builds expire after 90 days.
App privacy answers are app-level and should represent data practices across every platform. Re-audit them when Mac adds new file access, diagnostics, accounts, third-party SDK behavior, or data collection. Accessibility labels are device-specific; declare the Mac experience based on what common Mac tasks actually support.
- Apple · App Sandbox ↗
- Apple · TestFlight overview ↗
- Apple · Manage app privacy ↗
- Apple · Accessibility nutrition labels ↗
- Apple · Test compatible devices ↗
Give App Review a reproducible path
Each platform version is submitted separately. Attach the Mac build to the macOS version, add the version to review, and submit it. Review notes should remove uncertainty: give a working account, state where a reviewer finds the primary workflow, explain entitlements or unusual file access, list purchase products to exercise, and describe any dependency on the iPhone or iPad app.
Choose the release method deliberately and verify price, tax category, territories, agreements, and availability. Apple notes that an approved release can take up to 24 hours to appear.
Measure whether the Mac promise holds
Watch product-page conversion by source and territory, but do not stop at the download. Segment activation, purchase restoration, subscription access, retained use, review themes, support contacts, and crashes by platform and app version. A Mac launch is successful when the store page attracts people whose desktop job the product can keep serving.