Help for owners
Customers must be on Wi-Fi to install my iPhone app because it is too big
Short answer
Apple limits the size of apps people can install over a mobile connection; larger apps need Wi-Fi. App Store Connect shows the size of each app variant and warns you when it exceeds that limit. Read the size there, not from your build file, then ask your developer what takes the space.
Does this sound like your situation?
- Customers tell me the app will not install until they are on Wi-Fi.
- Downloads from the App Store are slower than for similar apps.
- App Store Connect shows a warning about the size of my app.
- The app has grown a lot since the first version and nobody knows why.
- My developer quotes one size, but the store shows another.
Why does this happen?
Apple caps installs over a mobile connection
The App Store limits the size of apps that can be installed over a mobile connection. If an app exceeds the limit, users need to connect to a Wi-Fi network to install it. Apple advises keeping the app well below the limit.
Confirmed by developer.apple.com
The size you see in the build file is not the size customers download
Apple says the app file, the archive and the file uploaded to App Store Connect are not suitable for measuring size, because they hold files customers never download, such as crash-report symbol files. The most accurate numbers are in App Store Connect, which shows the size for each variant of your app.
Confirmed by developer.apple.com
TestFlight builds look bigger than the store version
Apps distributed through TestFlight contain additional data that an App Store build does not have, so the TestFlight build is larger. Once approved, the store version can also end up slightly larger than the file uploaded, because the App Store processes the binaries again.
Confirmed by developer.apple.com
Large media and bundled data sit inside the app
Videos, big images, offline maps, fonts, and data files that are included in the app all count towards its size. Which of these is the biggest part is a question for the person who built it, and it usually differs from app to app.
The app was never measured
Apple recommends measuring size as part of development and testing. If nobody checks it at each release, it grows quietly until the store warning appears.
Confirmed by developer.apple.com
What can I do about it today?
- Open App Store Connect and find the size warningAsk your developer to show you the app sizes in App Store Connect, or open it yourself if you have access. It lists the size for each variant and warns when the limit is exceeded.
- Write down the sizesNote the number for the current release and, if you can find them, the last few releases. A list of numbers is what any later conversation needs.
- Ask what the biggest parts areSend your developer one question in writing: what are the five largest things inside the app? Videos, images, data files and libraries are the usual suspects.
- Do not delete features or content yourselfRemoving things to save space can break the app. Let the developer remove one thing at a time, with a test after each.
- Keep Wi-Fi installs working in the meantimeCustomers on Wi-Fi are not affected. A short note on your website or listing that large downloads need Wi-Fi saves you support questions.
When should I bring someone in?
- You do not know what is inside the app and your developer cannot say.
- The size keeps growing with every release.
- You are close to the limit and a new feature will add more.
How do I handle it?
- Measure like Apple doesI read the sizes in App Store Connect per variant and make an app size report with Xcode, because the file you build is not the size customers download.
- List what takes the spaceI break the app down into code, images, media, fonts and bundled data, and show you the biggest items in plain language.
- Change one thing at a timeEach reduction is made and tested on its own, so a smaller app does not become a broken app.
- Move large content out of the app where it makes senseContent that does not have to be installed on day one can be downloaded later, when it is needed. I explain the trade-off before I do it.
- Keep a size recordI note the size at every release so the growth is visible before the store warns you.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
What exactly is the size limit?
The page I read says only that the App Store limits the size of apps installed over a mobile connection and that larger apps need Wi-Fi. App Store Connect warns you if your app exceeds the limit, so use that warning rather than a number from memory.
Does a big app hurt me beyond the Wi-Fi rule?
Apple says the limit matters for download time and for people with limited storage, and advises keeping the app well below it to reach more installs.
Is my Android app affected the same way?
Google has its own size rules. See my page on an Android app that is too large.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.