Shared App Information
You can access these properties from the App Details page in the App Information section. This information is shared across any platform added to the app.
Property |
Description |
Editable |
---|---|---|
Primary Language |
The language you use to enter app details in iTunes Connect. Information provided in this language is used for any store territory for which there isn’t information localized in the territory’s primary language. The primary language applies only to store information. The languages your app supports are set in your build. |
Can be changed at any time to other languages for which you’ve provided localized metadata. |
Bundle ID |
An identifier used by iOS and OS X to recognize any future updates to your app. Your bundle ID must be registered with Apple and unique to your app. The same bundle ID can’t be used for both iOS and Mac apps. This property may be an explicit App ID or a wildcard App ID. If it’s a wildcard App ID, you also need to specify a bundle ID suffix. The bundle ID (combined with the bundle ID suffix) must exactly match the bundle identifier in your Xcode project |
Can’t be edited after a build has been uploaded. |
Bundle ID Suffix |
A string that is appended to the bundle ID property if the bundle ID is a wildcard App ID. The bundle ID and bundle ID suffix must form a bundle identifier that exactly matches the bundle identifier in your Xcode project |
Can’t be edited after a build has been uploaded. |
Apple ID |
A unique number that Apple assigns to the app. |
Can’t be edited. |
SKU Number |
A unique ID for your app in the Apple system that is not seen by users. You can use letters, numbers, hyphens, periods, and underscores. The SKU can’t start with a hyphen, period, or underscore. Use a value that is meaningful to your organization. |
Can’t be edited after saving the iTunes Connect record. |
Name |
The localized name of your app as it appears on the store. The app name must be at least two characters and no more than 75 bytes. Note: After you submit an app, you can change its name only the next time you update the app build with a new version. Otherwise, to change the name you must reject the app and resubmit it. |
Locked |
Privacy Policy URL (optional) |
A URL that links to your company’s privacy policy. Privacy policy URLs are required for all apps that offer auto-renewable or free subscriptions, apps that are set to Made for Kids, and apps that contain Research Kit. Customers see this URL on their invoice and on the subscription confirmation email they receive. The URL can specify a localized site. Include the entire URL, including the protocol. Note that if your app is set to Made for Kids, you need to specify a Privacy policy URL for each localization provided for the app. |
Unlocked |
Primary Category(required) / Secondary Category(optional) |
The categories that best describe the app you’re adding. For a list of categories and their descriptions, click the App Store Category Definitions link in the Category section of the Version Information. For Mac apps, you must define a category in the Note that if you select the primary or secondary category of Magazines & Newspapers, in order to submit your app for review you will be required to have at least one auto-renewable or free In-App Purchase subscription, and your app must use the Newsstand SDK. |
Locked |
Subcategory(optional) |
Subcategories for games. If you select Games or Magazines & Newspapers as the Primary or Secondary Category, you can also select one or two subcategories to help more accurately define your app or game. |
Locked |
License Agreement |
License agreement details are described in License Agreement. |
Unlocked |
Platform Version Information
The following properties contain the text and images that appear for the app in stores for each territory in which the app is available for sale or download. For information about setting the initial values, see Creating an iTunes Connect Record for an App. For information about updating these values, seeViewing and Changing Your App’s Metadata.
Property |
Description |
Editable |
---|---|---|
Language |
The language of this metadata. |
Locked |
Screenshots |
One screenshot per localization is required and up to 4 more are optional. For specifications of screenshots, readScreenshot Properties. |
Locked |
App Preview |
An app preview is an optional short video demonstrating your app. Your app may have one app preview per device. For specifications of app previews, read App Preview Properties. |
Locked |
Description(required) |
A localized description of the app, detailing the features and functionality. Descriptions are limited to 4000 bytes. The description should be in plain text, with line breaks as needed. HTML formatting isn’t recognized. Make sure to check your text for spelling or grammar errors. |
Unlocked |
What’s New in this Version(required) |
Localized release notes detailing the changes in this version of your app. For example, you might want to list new features, UI improvements, or bug fixes. This text can be as long as 4000 bytes. This field isn’t available for the first version of an app. |
Unlocked |
Keywords(required) |
One or more localized keywords that describe your app. Separate search terms with commas. At least one keyword of greater than two characters is required. You can provide up to 100 bytes of content. Your app is searchable by app name and company name, so you do not need to duplicate these values in the keyword list. Names of other apps or companies are not allowed. |
Locked |
Support URL(required) |
The support website you plan to provide for users who have questions regarding the app. The support URL must lead to actual contact information so that your users can contact you regarding app issues, general feedback, and feature enhancement requests. The URL can specify a localized site. Include the entire URL, including the protocol. For example, |
Unlocked |
Marketing URL(optional) |
The website where users get more information about the app. The URL can specify a localized site. Include the entire URL, including the protocol. |
Unlocked |
App Icon(required for iOS apps) |
The large app icon is displayed for your app on the App Store and, if needed, is used to feature your app on the App Store. iOS app icons need to meet the following requirements:
Note: The small icon (57 x 57 pixels for iPhone and iPod touch, 50 x 50 pixels and 72 x 72 pixels for iPad) that you include inside the build is used on the device Home screen when installed. |
Locked |
Version Number(required) |
The version number of the app you’re adding. This is the version number that will display on the App Store for customers. Numbering should follow typical software versioning conventions (for example, 1.0 , 1.0.1 , 1.1 ). When you create a new app or platform the version number will always default to 1.0, but this can be changed before you submit the app for review. Important: Make sure this App Store version number matches the version number set in the bundle. If these don’t match, upload errors for later updates might occur. |
Locked |
Rating(required) |
The rating for your app for the purpose of parental controls on the store. For more information, read Set App Ratings. Note that while the rating is set for each platform version individually, the final app rating will be determined by the highest rated platform version for the app and will be displayed in the App Information section. |
Locked |
Made for Kids(optional) |
An indication that the app appears in the Kids category on the store; this property includes the age range set for the app. If the app rating changes after enabling Made for Kids and the app no longer qualifies for the category, you’ll see an error when you save the options on the page. Note that the app will only be listed as Made for Kids if all of the platform versions are enabled as Made for Kids. For more information, read Made for Kids: Target Kid-Friendly Apps. After the app is approved as “Made for Kids,” all future versions of the app must also be “Made for Kids” and conform to Section 24. Kids Category in the App Store Review Guidelines. The app can’t be removed from the “Kids” category once it’s available for sale on the App Store. |
Locked |
Copyright(required) |
The name of the person or entity that owns the exclusive rights to the app, preceded by the year the rights were obtained (for example, 2014 Example, Inc.). The copyright symbol is added automatically. |
Unlocked |
Trade Representative Contact information |
Details are explained in Trade Representative Contact Information. |
Unlocked |
Routing App Coverage File(optional) |
Routing app coverage files are For information about the requirements of this file, read Specifying the Geographic Coverage File Contents in Location and Maps Programming Guide. |
Unlocked |
Version Release Settings |
See Specifying When App Versions Are Released. The following settings are allowed:
|
Locked |
App File Size |
When a build is uploaded to iTunes Connect it goes through a process of thinning, encryption, and recompression. During this process, the file size of the build can change. More information on App Thinning can be found in the App Distribution Guide. When you click the App Store File Sizes link, you will see a table of the different device variant sizes of the build, including the universal variant, as follows:
If any of the device variant sizes exceed the 100 MB over-the-air download limit, a yellow warning will display next to the variant size in the table. Apple will also send you an email with this information. Note that until the app is approved by App Review, the sizes displayed are only estimates of what the final App Store size will be. After the app has been approved, the sizes will be updated to reflect the final values. |
Read Only |
Screenshot Properties
Device |
Specifications |
Editable |
---|---|---|
3.5-Inch Retina Display Screenshots(required) |
One screenshot is required. Up to four additional screenshots can be uploaded. You can rearrange the screenshots when you create or edit the iTunes Connect record. Screenshot requirements are:
|
Locked |
4-Inch Retina Display Screenshots (Required) |
You’re required to upload at least one of these screenshots. Up to four additional optional screenshots can be uploaded. You can rearrange the screenshots when you create or edit the iTunes Connect record. Screenshot requirements are:
|
Locked |
4.7-inch Retina screenshot |
If your app indicates that it is optimized for the iPhone 6, at least one 4.7-inch screenshot is required. Up to four additional screenshots can be uploaded. You can rearrange the screenshots when you create or edit the iTunes Connect record. Screenshot requirements are:
|
Locked |
5.5-inch Retina screenshot |
Screenshot requirements are:
|
Locked |
iPad Screenshots(required if app runs on iPad) |
If your build indicates that your app runs on iPad, you’re required to upload at least one iPad screenshot. Up to four additional screenshots can be uploaded. You can rearrange the screenshots when you create or edit the iTunes Connect record. Screenshot requirements are:
|
Locked |
iPad Pro Screenshots |
If your build indicates that your app runs on iPad, you’re required to upload at least one iPad Pro screenshot. Up to four additional screenshots can be uploaded. You can rearrange the screenshots when you create or edit the iTunes Connect record. Screenshot requirements are:
|
Locked |
Mac (OS X) Screenshots
One OS X screenshot is required for Mac apps; up to four additional screenshots can be uploaded. Screenshots appear on the store in the order they were uploaded in iTunes Connect.
Device |
Specifications |
Editable |
---|---|---|
Mac Screenshots OS X only (required) |
Screenshot requirements are:
|
Locked |
tvOS Screenshots
If your app is a tvOS app, at least one screenshot is required. Up to four additional screenshots can be uploaded. You can rearrange the screenshots when you create or edit the iTunes Connect record.
Device |
Specifications |
Editable |
---|---|---|
tvOS Screenshots |
Screenshot requirements are:
|
Locked |
Apple Watch Properties
If you upload an app with a WatchKit extension, the Apple Watch properties appear below the Version Information properties on the Version Summary page. (To view version information, read Viewing and Changing Your App’s Metadata.) There isn’t a separate WatchKit extension description but the version description, described in Platform Version Information, can mention the WatchKit extension functionality.
You need to provide these additional properties for apps with WatchKit extensions:
Property |
Description |
---|---|
Icon |
Displays on Apple Watch product page and Apple Watch badge for the iOS app product page. Apple applies a circular mask to the icon. Icon should look good with the mask and be similar to the app icon. The icon needs to meet the following requirements:
|
Screenshots |
One screenshot is required. Up to four additional screenshots can be uploaded. Screenshots should suggest what the WatchKit extension does. Screenshot requirements are:
|
App Preview Properties
The resolutions for app previews for the supported displays are specified in App Sandbox Information.
Uploads must be done using Safari and OS X 10.10, and only one localization is accepted. App previews must disclose In-App Purchases and may contain no ads, no platform logos, no pricing, and no timelines.
App preview properties are locked, and so they can only be edited when the app is in an editable state.
The app preview feature is not available for 3.5 inch display.
App Preview Resolutions
Native Resolution |
Accepted Landscape Resolutions |
Accepted Portrait Resolutions | |
---|---|---|---|
5 Series |
1136 x 640 (16:9) |
1920 x 1080 or 1136 x 640 |
1080 x 1920 or 640 x 1136 |
iPad and iPad Pro |
2048 x 1536 (4:3) |
1200 x 900 or 1600 x 1200 |
900 x 1200 or 1200 x 1600 |
iPhone 6 |
1334 x 750 |
1334 x 750 |
750 x 1334 |
iPhone 6 Plus |
2208 x 1242 (Rendered Pixels) 1920 x 1080 (Physical Pixels) |
1920 x 1080 |
1080 x 1920 |
AppleTV |
1920 x 1080 (16:9) |
1920 x 1080 |
n/a |
App Preview Specifications
H.264 |
ProRes 422 HQ only |
Notes | |
---|---|---|---|
Target Bit Rate |
10-12 Mbps |
VBR ~220 Mbps |
|
Video Characteristics |
Progressive, up to High Profile Level 4.0 |
Progressive, no external references |
|
Max Frame Rate |
30 fps |
30 fps |
|
Audio |
|
|
Stereo configuration:
|
Supported Extensions |
.mov, .m4v, .mp4 |
.mov |
|
Max File Size |
500MB |
500MB |
|
Min Length |
15 seconds |
15 seconds |
|
Max Length |
30 sec |
30 sec |
|
Poster Frame |
5 sec default |
5 sec default |
5 sec default will be set at upload time. The developer can change the poster frame until the app is in review. Poster frame changes post on approved previews will require a new build version. |
Orientation |
Portrait or Landscape |
Portrait or Landscape |
Preview will play in the orientation provided by the developer. The product page will show previews in portrait. Once it played the preview will rotate to native orientation. Only landscape orientation app previews can be provided for tvOS binaries. |
Capture |
iOS 8 |
iOS 8 |
|
Upload and Playback in iTunes Connect |
Safari 8 and OS X 10.10 |
Safari 8 and OS X 10.10 |
|
View/Play on Device |
iOS 8 |
iOS 8 |