Search
Clear search
Close search
Google apps
Main menu

Add, remove, or test APK expansion files

If your app needs more than 100MB of memory, you can use expansion files to store additional APK assets. You can store two expansion files per application. Each expansion file can be up to 2GB in size.

APK files have a maximum file size, based on the Android version your APK supports:

  • 100MB - APKs that target Android 2.3 and higher (API level 9-10 and 14+)
  • 50MB - APKs that target Android 2.2 and lower (API level 8 or lower)

Tip: Users must run Play Store version 5.2 or higher to install 100MB APKs.

Expansion files are hosted at no additional cost. When possible, Google Play will download expansion files when apps are installed or updated. In some cases, your app will need to download its expansion files.

If your expansion files are larger than 100MB, users will see a warning dialog suggesting that they use Wi-Fi to download your app.

Expansion file types

When you use expansion files, one file is the main file and the other is an optional patch file. Optional patch files are usually used for small updates to the main file.

Expansion files can be any type of file and are saved to a device’s shared storage location (example: SD card or USB-mountable partition) where your app can access them. Every expansion file URL issued is unique to every download.

Manage expansion files

Add expansion files

You can upload new or add existing expansion files when uploading a new APK into a draft release.

  1. Go to your Play Console.
  2. Select your app.
  3. On the left menu, click Release management > App releases.
  4. Next to the release type you want to update, select Manage.
  5. Select Upload APK.
  6. Drop or select your app's APK file.
  7. Under "Use expansion files," select the No expansion file drop-down.
  8. Choose whether you want to upload a new file or attach an existing expansion file.
  9. Click Save draft.

Note: You can't remove expansion files from an existing release. If you no longer want to include an expansion file with your APK, create a new release with a new APK that doesn't have the expansion file(s).

Test expansion files

Before publishing your app, make sure to test your expansion file implementation.

APK expansion files can't be tested with draft apps. To test APK expansion files, your APK must be published to alpha, beta, or production.

Was this article helpful?
How can we improve it?