What is an OBB file and where does it go?
OBB files store large Android expansion data. They usually belong in Android/obb/<package.name>/ beside a correctly installed APK.
Updated 2026-11-22 · 8 min read · apktools editorial
What an OBB file is
OBB stands for opaque binary blob. In Android, OBB files are expansion files that hold large assets outside the main APK. Games use them for maps, audio, video, and other content that would make the installable package awkward to ship or update.
An OBB is not an alternate APK. Installing the APK alone does not unpack OBB contents into the app sandbox automatically in the way many users expect. The app reads expansion files from a known storage location after install.
How OBB files are named
Expansion filenames usually follow a strict pattern:
- main.<versionCode>.<package.name>.obb for the primary expansion
- patch.<versionCode>.<package.name>.obb for a patch expansion
Version codes must align
The number in the OBB name is typically the APK versionCode the expansion belongs to. If you update the APK but keep an old main.<oldVersion>.package.obb without a matching patch strategy, the app may ignore the file or fail asset checks. When extracting from an XAPK, keep the OBB names exactly as packaged unless you know the app’s expansion rules.
Where OBB files go on the device
The standard shared-storage location is Android/obb/<package.name>/ with filenames such as main.<version>.<package.name>.obb and patch.<version>.<package.name>.obb.
For package com.example.game and version code 120, a typical path is Android/obb/com.example.game/main.120.com.example.game.obb. On modern Android releases, access rules for Android/obb can be stricter depending on the app and OS version. Apps that declare the right access patterns can still read their own expansion files from that conventional location.
- Android/obb/<package.name>/main.<version>.<package.name>.obb
- Android/obb/<package.name>/patch.<version>.<package.name>.obb
How OBB files relate to XAPK archives
Many XAPK files exist specifically to carry APKs and OBB data together. The XAPK manifest often lists expansion entries and suggested install paths. After you extract with an XAPK tool, copy those OBB files into the package folder on the device. If you skip that step, the APK may install while the game content stays missing.
When you are creating a test archive, the APK to XAPK packer can bundle an APK with OBB files and generate a simple manifest. That is useful for QA handoff, not for distributing pirated content.
Pushing OBB files with ADB
During development, adb push is a reliable way to place expansions:
- adb push "./main.120.com.example.game.obb" "/sdcard/Android/obb/com.example.game/main.120.com.example.game.obb"
Generate commands automatically
If your source archive is an XAPK, the ADB command generator on apktools can propose install-multiple and OBB push commands after it parses the package locally. Review package names carefully before running anything on a physical device.
Common OBB problems
Wrong folder, wrong filename, wrong version code, and incomplete copies are the frequent failures. Storage permission changes across Android versions can also affect file managers you use to move OBBs. If an app asks to download additional assets after install, it may be trying to fetch expansions itself because it cannot see the local files.
When storage is nearly full, OBB copies can truncate. Compare file sizes against the extracted originals. Hash checks help when you move large files over unstable connections.
A clear note on rights and sources
OBB files are part of an app’s paid or licensed content just like the APK. apktools helps you place and inspect files you already have rights to use. We do not host OBB packs, game mirrors, or APK download catalogs.
Frequently asked questions
Can I open an OBB like a zip?
Sometimes OBB contents are zip-like, but many are opaque containers meant for the app. Installing and placing the file correctly matters more than unpacking it manually.
Do all Android apps use OBB files?
No. Many apps keep assets inside the APK or download content after install. OBB is common for larger games and older expansion workflows.
Where do I find the package name for the folder?
Read it from the XAPK manifest or from the base APK with an APK info tool. The folder must match that package name.
Is Android/data the same as Android/obb?
No. Android/data holds app-specific data directories. Expansion files conventionally live under Android/obb/<package.name>/.
Related tools
Related guides
What is an XAPK file?
An XAPK is a zip-style Android package that often bundles a base APK, split APKs, and OBB expansion files into one archive.
How to install XAPK on Android
Android does not install .xapk directly. Extract the archive, install the APK or splits, then place OBB files in the correct folder.
Fix “App not installed” error
When Android refuses an APK or split set, the cause is usually signatures, version codes, architecture, or a bad package file.