App Identity
App Identity settings control how your app identifies itself — the name users see, the icon on their home screen, and the unique identifiers that distinguish your app.Accessing App Identity
- Open your project
- Click Settings in the sidebar
- Select App Identity (or look under General)
Display Name
The name shown under your app icon and in iOS Settings.Requirements
- Maximum 30 characters (11 visible under icon)
- No special characters that could cause issues
- Should be unique and memorable
Tips
- Keep it short — long names get truncated
- Make it recognizable
- Consider searchability in the App Store
Changing the Name
- Settings → App Identity → Display Name
- Enter new name
- Save
App Icon
The icon users see on their home screen, in Settings, and throughout iOS.Requirements
- Size: 1024×1024 pixels
- Format: PNG
- No transparency — use a solid background
- No alpha channel — Apple rejects icons with transparency
Guidelines
- Simple, recognizable design
- Works at small sizes (the icon is shown at various sizes)
- Consistent with iOS design language
- No photos or screenshots of other apps
Uploading an Icon
- Settings → App Identity → App Icon
- Click upload or drag image
- Preview appears showing various sizes
- Save
Version Number
The public version of your app (e.g., 1.0, 1.1, 2.0).Format
major.minor.patch — for example: 1.2.3
- Major: Significant updates (2.0)
- Minor: New features (1.1)
- Patch: Bug fixes (1.0.1)
When to Update
- Before each TestFlight upload
- Before App Store submission
- When releasing significant changes
Changing Version
- Settings → App Identity → Version
- Enter new version (e.g., “1.1”)
- Save
Build Number
Internal number for tracking builds. Must increase with each upload.Format
Any positive integer: 1, 2, 3, … or 100, 101, 102…When to Update
- Every time you upload to TestFlight
- Every time you submit to App Store
- Apple requires each build number to be unique
Strategy
Common approaches:- Simple increment: 1, 2, 3, 4…
- Date-based: 20240115 (YYYYMMDD)
- Combined: Version + build (1001, 1002, 1003…)
Bundle Identifier
A unique identifier for your app in Apple’s ecosystem.Format
Reverse domain notation:com.yourname.appname
Examples:
com.johndoe.todolistcom.mycompany.weatherappio.startup.fitnesstrack
Requirements
- Must be unique worldwide
- Only letters, numbers, periods, and hyphens
- Usually matches your domain (if you have one)
- Cannot be changed after App Store submission
Choosing a Bundle ID
If you don’t have a domain, use a personal format:com.yourname.appnameio.yourname.appname
Team ID
If you have an Apple Developer account, your Team ID links your app to your account.Where to Find It
- Apple Developer Portal
- Account → Membership → Team ID
When It’s Needed
- TestFlight uploads
- App Store submission
- Capabilities requiring entitlements
Quick Reference
| Setting | Where It Appears | When to Change |
|---|---|---|
| Display Name | Home screen, iOS Settings | When you want a new name |
| App Icon | Home screen, everywhere | New branding, refresh |
| Version | App Store, Settings | Each release |
| Build Number | TestFlight, internal | Every upload |
| Bundle ID | Nowhere visible | Never (after release) |
Common Tasks
Change app name for rebranding
Change app name for rebranding
- Settings → App Identity → Display Name
- Enter new name
- Save and rebuild
- For App Store, also update listing in App Store Connect
Prepare for TestFlight upload
Prepare for TestFlight upload
Before uploading:
- Update Version if it’s a new release
- Always increment Build Number
- Verify App Icon looks good
- Check Bundle ID matches your developer account
Fix rejected icon (transparency)
Fix rejected icon (transparency)
- Open your icon in image editor
- Ensure no transparency (alpha channel)
- Export as PNG without alpha
- Re-upload to Nativeline