Google Play Target API Level: What the Yearly Update Requires
Short answer
Google Play requires new apps and app updates to target an Android API level within one year of the latest major Android release, and existing apps to stay within two years to remain available to new users on newer devices. Because the bar rises every year, every Android app needs a yearly update that raises targetSdk, upgrades dependencies and tests the behavior changes that come with it.
How the target API level rule works
The target API level (targetSdk in your Gradle build) tells Android which version's behavior your app is designed for. Google uses it to keep apps on Play reasonably current. The rule has two parts:
- New apps and updates must target an API level within one year of the latest major Android release. If your target is too old, the Play Console blocks the upload.
- Existing apps that are not updated must target an API level within two years of the latest release. Otherwise they stay installed for current users but are no longer offered to new users whose devices run newer Android versions.
Google typically announces the new requirement in advance and enforces it in the second half of the year. In many cases you can request a short extension in the Play Console. Wear OS, Android TV and Android Automotive apps have their own target levels.
What tends to break when you raise targetSdk
Raising the target level opts your app into behavior changes. If you skipped several years, you collect all of them at once. Examples that commonly need code changes:
| Android version (API) | Typical change |
|---|---|
| Android 12 (31) | Components with intent filters must declare android:exported; PendingIntents need an explicit mutability flag |
| Android 13 (33) | Apps request the notification permission themselves; granular media permissions replace broad storage access |
| Android 14 (34) | Foreground services must declare a type; runtime-registered broadcast receivers must state whether they are exported |
| Android 15 (35) | Edge-to-edge display is enforced, so content can slide under status and navigation bars |
| Android 16 (36) | On large screens, orientation and resizability restrictions are ignored; the edge-to-edge opt-out no longer applies |
Separate from the target level, Google Play also requires apps with native libraries that target recent Android versions to support 16 KB memory page sizes, and it phases out old Play Billing Library versions on a rolling schedule. Either can block an update, so check them in the same pass.
A safe update workflow
- Check the Play Console for policy warnings and the deadline shown for your app.
- Upgrade the toolchain: Android Gradle Plugin, Gradle, Kotlin and the Android SDK, then raise compileSdk and targetSdk.
- Upgrade the framework if you use one. Flutter, React Native, Capacitor and Cordova projects often need a framework update before a higher target works.
- Update dependencies such as Firebase, Google Play services, push and analytics SDKs.
- Work through the official behavior-change lists for every version you skip, not just the newest.
- Test on the newest emulator image and on your minimum supported version, with a focus on notifications, file uploads, background work, deep links and layout.
- Release via the internal track, check the pre-launch report and Android vitals, then use a staged rollout.
Keeping older apps listed
Many Android apps fall out of compliance not because of complexity but because nobody owns them any more: the agency is gone, the build environment is outdated or the signing key's location is unknown. If you cannot update in time, current users keep the app, but growth stops on newer devices and every later fix gets harder. Treat the target API update as a yearly maintenance task with a calendar entry, a budget and someone responsible. If an app is no longer worth maintaining, unpublishing it deliberately is better than leaving it to decay.
How jocapps can help
appsubmitter.io raises the target API level, sets up CI/CD and signing and submits the update in your own Play Console, with AI-assisted checks and App Specialists who handle policy warnings and rejections. For apps that need continuous care, apprat.io combines AI-assisted development with a monthly budget of human developer hours, so the yearly update becomes routine maintenance. For background on policy issues, see our guide to Google Play rejections, or book a free 30-minute call via the meeting planner.
Frequently asked questions
What happens if I miss the target API level deadline?
You cannot publish updates until you raise the target level, and if the app falls below the two-year threshold it is no longer offered to new users on newer Android devices. Existing installs keep working.
Can I get more time?
The Play Console usually lets you request a limited extension. Use it to finish the update, not to postpone planning.
Does raising targetSdk drop support for older phones?
No. The minimum supported version is set by minSdk. Raising targetSdk changes behavior on newer Android versions only.
Do WebView wrapper apps need this update too?
Yes. Every app on Google Play is subject to the rule, and wrapper apps are typically affected by notification permissions, file uploads and edge-to-edge layout changes.
Guides on this topic
- Store launchGoogle Play Rejections and Policy Violations: A Fix-It Guide
- Store launchCI/CD for AI-Generated Mobile Apps: A Pipeline That Catches What Agents Miss
- CodexCodex + Kotlin: Releasing an Agent-Built Android App
- Claude CodeFrom Claude Code to Google Play: Shipping Android Apps Built With Agents
Related solutions
- App Store and Google PlayApp Maintenance After Launch: OS Updates, SDKs, Certificates, Budget
- App Store and Google PlayApp Store and Google Play Screenshots, Videos and Metadata Done Right
- App Store and Google PlayRejected Under Apple Guideline 4.3 Spam? Causes, Replies and Fixes
- App Store and Google PlayFixing an Apple Guideline 5.1.1 Data Collection and Privacy Rejection
Talk to us about your project
Honest advice on your idea, prototype or app.
- 30 minutes
- Free
- No obligation
