Search
Clear search
Close search
Google apps
Main menu
true

Add 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 app. 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 downloads 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 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 or change expansion files

You can upload new or add existing expansion files to APKs in 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. Drop or select your app's APK file.
  6. You'll see a list of APKs that are associated with your release. Next to the relevant version code, select the add icon .
  7. Choose whether you want to upload a new file or attach an existing expansion file.
    • If the APK hasn't been published yet, you can change or remove an expansion file by selecting another file or No expansion file. You can't remove expansion files from an existing release.
  8. Select Save.
Remove expansion files

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 release with a new APK that doesn't have the expansion file.

For APKs that haven't been published yet, you can change the attached expansion files at any time.

  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. You'll see a list of APKs that are associated with your release. Next to the relevant version code, select the add icon .
  6. Select the down arrow Drop-down arrow.
  7. Select No expansion file > Save.
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?