App stores
What is a bundle ID?
Short answer
A bundle ID is the unique string that identifies an iOS app, such as com.example.app. Android’s equivalent is the application ID, usually called the package name. You choose both, they normally follow reverse-domain style, and neither should change after the app is published. Google Play links and assetlinks.json use the package name.
The bundle ID on iOS
You set the bundle ID in Xcode, and the one registered in App Store Connect has to match it. Apple allows letters, digits, hyphens and periods, and treats the string as case-insensitive. Most teams use reverse-domain style: com.company.appname.
Once you upload a build, the bundle ID is locked. It is separate from the App Store ID, the number in your App Store link. The store uses the number; the system and your developer account use the bundle ID.
The package name on Android
Android calls it the application ID, set as applicationId in the module’s Gradle build file. It looks like a Java package name, and many Android APIs and the Play Console still call it the package name. Google says it uniquely identifies your app on the device and in Google Play.
Don’t change it after publishing. Google Play treats an upload with a different application ID as a completely different app, so the existing listing and its users stay with the old ID.
The iOS bundle ID and the Android package name don’t have to match each other. Many apps use the same string for both because it is easier to keep track of.
Where links use them
On Android the package name is the store address. It is the id= value in a Google Play link, and RuStore, Galaxy Store and Xiaomi GetApps key their pages to the same string. Huawei AppGallery is the exception, with an app ID of its own.
Deep linking uses both identifiers. For Universal Links, the apple-app-site-association (AASA) file lists your app as the Team ID followed by the bundle ID. For Android App Links, assetlinks.json names the package and the signing certificate fingerprint. A typo in either file means links open the browser instead of the app.
An intent URL or a market:// link also names the Android package, which is how the phone knows which app or store page to open.
https://play.google.com/store/apps/details?id=com.example.appTry it here
Make one link for every store
Paste your App Store and Google Play links, and AppGallery if you use it. iPhones go to the App Store, Android phones to Google Play and computers to your website.
Make your one link
Copy it from your App Store page or from App Store Connect.
The address of your Play Store listing, the one with ?id= in it.
Only you see it, in your dashboard.
Free plan. No credit card.
What happens next
- 01Sign up free with Google or email
- 02We create your link and QR code
- 03Add your logo, download and print
Frequently asked questions
Is the bundle ID the same as the Android package name?
They do the same job on different platforms. The bundle ID identifies an iOS app and the application ID, or package name, identifies an Android app. They can be identical strings, but nothing requires it, and each store only knows its own.
Can I change a bundle ID or package name after release?
No, not without creating a new app. In App Store Connect the bundle ID can’t be changed once a build is uploaded. On Google Play, an upload with a different application ID is treated as a completely different app.
Where do I find the package name of an Android app?
It is the value after id= in the app’s Google Play link, for example com.example.app. For your own app, it is the applicationId in the module’s Gradle build file, and it is also visible in the Play Console.
Related terms
- App Store ID
An App Store ID is the number Apple assigns to an app when it is added to App Store Connect. It is the digits after id in apps.apple.com/app/id123456789. App Store Connect calls it the Apple ID. It never changes, and App Store links, campaign links and Smart App Banners all identify the app by it.
- apple-app-site-association (AASA)
The apple-app-site-association (AASA) file is a JSON file on your domain that tells iOS which apps may open which links there. It lives at /.well-known/apple-app-site-association, must be served over HTTPS without redirects, and lists each app by its Team ID and bundle ID together with the paths it handles.
- assetlinks.json
assetlinks.json is the Digital Asset Links file that proves to Android your domain trusts your app, so verified App Links open the app directly. It sits at /.well-known/assetlinks.json, is served over HTTPS as JSON without redirects, and lists your package name with the SHA-256 fingerprints of your signing certificates.
One link for every phone
Create a free smart link and QR code that sends iPhones to the App Store, Android phones to Google Play and desktops to your website.