Maximum build file sizes

Verify that your app, along with each Mach-O executable file (for example, app_name.app/app_name), doesn’t exceed the maximum file size limits on the supported operating systems.

For iOS, iPadOS, macOS, tvOS, and visionOS apps, you can use Background Assets to host larger assets that are managed separately from your build.

Platform	Maximum uncompressed app size
iOS and iPadOS	iOS 9.0 and later iOS 7.X through iOS 8.X Earlier than iOS 7.0	4 GB	500 MB ¹ 60 MB ² 80 MB ¹
macOS	All macOS versions	200 GB
tvOS	tvOS 9.0 and later	4 GB	500 MB ¹
visionOS	visionOS 1.0 and later	4 GB	500 MB ¹
watchOS	All watchOS versions	75 MB

¹ For the total of all __TEXT sections in the binary.

² For the __TEXT sections in each architecture slice. An architecture slice is a part of the fat binary layout that targets a specific architecture. For example, a fat binary might include slices for 32-bit and 64-bit architectures.

App Clips

To ensure a successful launch experience, verify that the uncompressed main bundle of any App Clip variant, after app thinning, doesn’t exceed the maximum size limit for the minimum deployment target used in the App Clip.

Learn how to measure the size of your App Clip.

Minimum deployment target	Maximum variant size	Notes
iOS 17 and later	100 MB	Following requirements must be met: The App Clip only supports digital invocations — for example, from your website or Spotlight search — and not from physical invocations like App Clip Codes, QR codes, or NFC tags. People use your App Clip in situations where a reliable internet connection is likely, for example, at home. Your App Clip doesn’t support iOS versions prior to iOS 17.
iOS 16 and later	15 MB
Earlier than iOS 16	10 MB

Minimum deployment target

Maximum variant size

Notes

iOS 17 and later

100 MB

Following requirements must be met:

The App Clip only supports digital invocations — for example, from your website or Spotlight search — and not from physical invocations like App Clip Codes, QR codes, or NFC tags.
People use your App Clip in situations where a reliable internet connection is likely, for example, at home.
Your App Clip doesn’t support iOS versions prior to iOS 17.

iOS 16 and later

15 MB

Earlier than iOS 16

10 MB