“There Was a Problem Parsing the Package”: 7 Fixes That Actually Work
You tap an APK, Android thinks for a second, and then: “There was a problem parsing the package.” The message sounds technical, but it has a simple meaning. Android opened the file, tried to read it as an app, and couldn’t. The question is why it couldn’t, and there are only a handful of real answers. This guide goes through them from most to least common, with a quick way to figure out which one is yours.
If your phone says “App not installed” instead, that’s a different error with its own causes. See our App Not Installed guide.
Quick Diagnosis
| What you notice | Most likely cause | Go to |
|---|---|---|
| The file is much smaller than the listing says | Incomplete or corrupted download | Fix 1 |
| The file ends in .xapk, .apks, .apkm or .zip | It’s not a plain APK | Fix 2 and Fix 3 |
| Your phone runs an older Android version | App needs a newer Android | Fix 4 |
| You opened the file from a chat app or cloud preview | Installer can’t read it from there | Fix 5 |
| The file came from a “patched” or “modded” source | Broken or missing signature | Fix 6 |
| None of the above | Read the actual error code | Fix 7 |
Fix 1: Check the File Size, Then Download Again
The most common cause is simply a file that didn’t finish downloading. A dropped connection, a browser that went to the background, or a nearly full phone can all leave you with a truncated file that looks normal in your Downloads folder.
- Compare the file size on your phone against the size shown on the download page or the official Play Store listing.
- If it’s noticeably smaller, delete it.
- Download again on a stable connection and wait for the browser to finish before tapping the file.
A file that’s only a few kilobytes is usually a web page saved by mistake (an error or redirect page), not an app at all.
Fix 2: Make Sure It’s Really an APK
A plain APK ends in .apk. Several other formats look similar but are archives that contain more than one file:
- XAPK: an APK plus extra data files
- APKS and APKM: bundles of several split APK files
- ZIP: sometimes an APK is downloaded inside a zip and needs to be extracted first
Renaming one of these to .apk doesn’t turn it into an APK, and it’s a classic way to trigger this exact error. If you’ve got a bundle, move to Fix 3.
Fix 3: Install Bundles the Right Way
Modern apps are often distributed as a set of files: a base APK plus smaller split files for screen density, CPU type or language. Tapping just one piece, or installing them one at a time, fails.
You need an installer that handles the whole set together, or ADB’s install-multiple command. We explain both in How to Install Split APK Files. If you’ve ever wondered what a file called split_config.xxhdpi.apk is, that guide covers it too.
Fix 4: Check Your Android Version
Every app declares the oldest Android version it supports. If your phone is older than that, installation can fail, and on some Android versions the failure shows up as a parsing error instead of a clear “needs newer Android” message.
- Open Settings → About phone and note your Android version.
- Look up the app’s minimum Android requirement on its Play Store listing.
- If your phone is below it, you’ll need an older release of the app that still supports your version, or a newer phone.
Fix 5: Open the File From Your Files App
Some phones struggle to install directly from a chat app preview, an email attachment or a cloud storage viewer, because the file is held in a temporary or restricted location.
- Save the file to your phone’s Downloads folder.
- Open a file manager such as Files by Google.
- Tap the APK from there.
Our general APK install guide walks through the permission prompts if Android asks you to allow installs from that app.
Fix 6: Avoid Modified or “Patched” Files
Android checks that every APK has a valid digital signature before installing it. Modified, cracked or badly repackaged files often have a missing, broken or mismatched signature, and Android refuses to read them.
If the file came from a source promising “unlocked”, “premium free” or “unlimited” versions, treat the parsing error as a warning, not an obstacle to work around. Our Complete Guide to APK Safety explains why modified builds are a common malware route, and How to Spot a Fake or Cloned Android App shows what lookalike files look like. Don’t switch off Play Protect to force one through.
Fix 7: Read the Real Error With ADB
The message on your screen is vague on purpose. If you connect the phone to a computer with USB debugging enabled and run adb install app.apk, you get a specific error code that points straight at the cause. (ADB setup is covered in the ADB section of our Android TV box guide.)
| Error code | What it usually means |
|---|---|
INSTALL_PARSE_FAILED_NOT_APK |
The file isn’t a valid APK (wrong format or corrupted) |
INSTALL_PARSE_FAILED_NO_CERTIFICATES |
The file has no valid signature |
INSTALL_PARSE_FAILED_MANIFEST_MALFORMED |
The app’s manifest is broken or has been altered |
INSTALL_FAILED_OLDER_SDK |
The app needs a newer Android version |
INSTALL_FAILED_NO_MATCHING_ABIS |
The app was built for a different CPU type |
Match your code to the table and you’ll know which of the fixes above applies.
Still Stuck?
If you’ve worked through all seven and the error remains, the file itself is most likely the problem. Get it again from a source you can verify by checking the package name, publisher and size against the official listing. For how we handle that on this site, see How We Verify APK Safety.
FAQ
What does “problem parsing the package” mean? Android couldn’t read the file as a valid app. The usual reasons are an incomplete download, a file that isn’t a plain APK, an app that needs a newer Android version, or a damaged or unsigned file.
Is this the same as “App not installed”? No. They’re related, but “App not installed” has other common causes such as storage, version conflicts and permissions. See the App Not Installed guide.
Can I fix it by renaming the file to .apk? Not if the file is an XAPK, APKS or APKM bundle. Renaming changes the name, not the contents.
Does a parsing error mean the file is a virus? Not by itself. Most are simple download or format problems, but a modified file with a broken signature is a reason for extra caution.
Part of ApkPrompt’s install troubleshooting series. See also: How to Fix “App Not Installed”, How to Install Split APK Files, and How to Install APK Files on Android.