iTunes Connect App Properties

This appendix describes the properties of an app entered in iTunes Connect and displayed on the App Store or Mac App Store, as well as properties of iTunes Connect Users and Roles.

About This App

These properties identify an app in the iTunes Connect record. You can access them from the App Details page, under the More menu.

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 Info.plist file (found under the target’s General > Identity section).

Can’t be edited after the app is approved.

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 Info.plist file.

Can’t be edited after the app is approved.

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.

Version Information

Version Information properties include the localizable text and images that appear in the store.

Changes you make to version-level app information are posted immediately; expect 24 hours for a full refresh of the change on the store. For information about setting the initial values, see Creating an iTunes Connect Record for an App. For information about updating these values, see Viewing and Changing Your App’s Metadata.

You can see many of the Version Information properties for each store territory on your app’s Version Summary. See Viewing Version Details for Each Territory.

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, read Screenshot 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

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

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, http://support.example.com .

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

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 and for apps that are set to Made for Kids. 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

General App Information

General App Information properties are metadata that apply to all of the localizations.

These 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. They apply to specific versions of an app. For information about setting the initial values, see Creating an iTunes Connect Record for an App. For information about updating these values, see Viewing and Changing Your App’s Metadata.

General App Information properties are either locked or unlocked. Unlocked properties are always editable. Locked properties are only editable when your app is in an editable state. The tables in this section indicate whether a property is locked or unlocked. Changes you make to unlocked General App Information properties are posted immediately (expect 24 hours for a full refresh of the change on the store). See also About App Statuses.

Property

Description

Editable

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:

  • 1024 x 1024 pixels (don’t scale up smaller artwork, because this could appear pixelated and blurry)

  • 72 dpi, RGB, flattened, no transparency, no rounded corners

  • High-quality JPEG or PNG image file format.

To preview an image in a separate window before submitting it, click the filename.

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 ).

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

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 Info.plist file of your app build using the LSApplicationCategoryType key. The list of categories you can choose to define in your property list is the same as the available categories for Mac apps in iTunes Connect. The primary category selected in iTunes Connect should match the category defined in the app build property list.

Locked

Subcategory (optional)

Subcategories for games. If you select Games as the Primary or Secondary Category, you can also select one or two subcategories to help more accurately define your game.

Locked

Rating (required)

The rating for your app for the purpose of parental controls on the store. For more information, read Set App Ratings.

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.

For more information, read Made for Kids: Target Kid-Friendly Apps.

Locked

License Agreement

License agreement details are described in License Agreement.

Unlocked

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 .geojson files that specify the geographic regions supported by your app. The file can have only one MultiPolygon element. MultiPolygon elements consist of at least one Polygon. Polygons contain at least four coordinate points. The start and end coordinate points for a polygon must be the same.

For information about the requirements of this file, read Specifying the Geographic Coverage File Contents in Location and Maps Programming Guide.

Unlocked

Size

The final size of your app after it’s been uploaded, encrypted for DRM purposes, and recompressed. This value is not shown on App Details. It is available on the Version Summary page for your app, described in Reviewing Your Version Summary.

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.

Don’t include the device status bar in your screenshots. Screenshot requirements are:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format

  • Any of the following sizes:

    • 640 x 920 pixels for hi-res portrait (without status bar) minimum

    • 640 x 960 pixels for hi-res portrait (full screen) maximum

    • 960 x 600 pixels for hi-res landscape (without status bar) minimum

    • 960 x 640 pixels for hi-res landscape (full screen) maximum

    ../Art/ipod_dim_2x.png

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.

Don’t include the device status bar in your screenshots. Screenshot requirements are:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format

  • Any of the following sizes:

    • 640 x 1096 pixels for portrait (without status bar) minimum

    • 640 x 1136 pixels for portrait (full screen) maximum

    • 1136 x 600 pixels for landscape (without status bar) minimum

    • 1136 x 640 pixels for landscape (full screen) minimum

    ../Art/iphone_dim_2x.png

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:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format

  • 750 x 1334 pixels for hi-res portrait

  • 1334 x 750 pixels for hi-res landscape

Locked

5.5-inch Retina screenshot

If your app indicates that it is optimized for the iPhone 6 Plus, at least one 5.5-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:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format

  • 1242 x 2208 pixels for hi-res portrait

  • 2208 x 1242 pixels for hi-res landscape

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.

Don’t include the device status bar in your screenshots. Screenshots requirements are:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format

  • Any of the following sizes:

    • 1024 x 748 pixels for landscape (without status bar) minimum

    • 1024 x 768 pixels for landscape (full screen) maximum

    • 2048 x 1496 pixels for hi-res (without status bar) minimum

    • 2048 x 1536 pixels for hi-res landscape (full screen) maximum

    • 768 x 1004 pixels for portrait (without status bar) minimum

    • 768 x 1024 pixels for portrait (full screen) maximum

    • 1536 x 2008 pixels for hi-res portrait (without status bar) minimum

    • 1536 x 2048 pixels for hi-res portrait (full screen) maximum

    ../Art/ipad_dim_2x.png

Locked

Mac Screenshots OS X only (required)

One 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.

Screenshot requirements are:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format in the RGB color space

  • 16:10 aspect ratio

  • One of the following sizes:

    • 1280 x 800 pixels

    • 1440 x 900 pixels

    • 2880 x 1800 pixels

Locked

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

2048 x 1536 (4:3)

1200 x 900

900 x 1200

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

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

  • Codec: 256kbps AAC

  • Sample Rate: 44.1kHz or 48kHz

  • All tracks should be enabled

  • Stereo

  • Codec: PCM or 256kbps AAC

  • Bit Depth (for PCM): 16-, 24-, or 32-bit

  • Sample Rate: 44.1 or 48kHz

  • All tracks should be enabled

Stereo configuration:

  • 1 track with 2-channel stereo (1st channel L and 2nd channel R)

  • 2 tracks with 1-channel stereo (1st track L and 2nd track R)

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.

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

License Agreement

Apple provides a standard EULA (end-user license agreement) that applies in all territories. You can provide a document that supersedes the Apple EULA for one or more countries. You can provide only one EULA per app, so this document needs to contain agreement text appropriate for each territory where you want to apply your custom EULA. For information about creating a EULA, go to Instructions for Minimum Terms of Developer’s End-User License Agreement.

If you don’t provide a EULA, the standard EULA is applied to your app and the EULA link won’t be shown on the app page on the store. For the text of the standard agreement, go to Licensed Application End User License Agreement.

Property

Description

License Agreement (optional)

A plain text document describing the end-user license agreement that applies to this app in the countries indicated. All HTML tags are stripped and escaped, and only line break characters are accepted. Make sure that the text includes localized information that meets local legal and language requirements. Your license agreement text can include multiple languages.

Countries

The countries in which a custom EULA applies.

Trade Representative Contact Information

If your company is selling apps in the Korea App Store, iTunes Connect provides the opportunity for you to display trade representative contact information in compliance with Korean e-commerce regulations. The trade rep is someone within the company who has the authority to represent the company. Examples include the CEO, Representative Director, or other responsible officer within the company.

If you are based in the Republic of Korea, the contact information includes fields for your e-commerce and business registration numbers.

The App Store Contact Information displays only if your Apple Developer Program registration was for a company, not an individual.

Property

Description

Trade Rep First Name

The first name of the App Store contact.

Trade Rep Last Name

The last name of the App Store contact.

Email Address

The email address of the App Store contact.

Address Line 1

The physical address of the App Store contact.

Address Line 2

The physical address of the App Store contact.

City

The city of the App Store contact.

State

The state or province of the App Store contact.

Postal Code

The postal code for the App Store contact.

Country

The country of the App Store contact.

Email

The email address of the App Store contact.

Phone Number

The phone number of the App Store contact. Include the country code.

E-Commerce Registration Number

A registration number issued by the government of Korea for companies doing business on the Internet. This property appears only for organizations based in the Republic of Korea.

Business Registration Number

A registration number issued by the district tax authority in Korea to companies doing business in Korea. This property appears only for organizations based in the Republic of Korea.

Display in Korean App Store (optional)

An indication that the contact information is displayed in the Korea App Store. If selected, the first name, last name, and valid email address are required. If not selected, the contact information is not displayed in any store.

App Review Information

Contact Information properties provide information to Apple to support the app review process. This information never appears to users.

Property

Description

First Name (required)

Last Name (required)

Email Address (required)

Phone Number (required)

Contact information of the person in your organization who should be contacted if the App Review team has any questions or needs additional information.

Notes (optional)

Additional information about your app that can help during the review process. Include information that may be needed to test your app, such as app-specific settings and test registration or account details. The Review Notes field can contain up to 4000 bytes and can be provided in any language.

If your app delivers streaming video over the cellular network, enter a test stream URL in the Review Notes.

This text is visible only to the Apple review team.

Demo Account User Name (optional)

The user name for a full-access demo account. This account is used during the app review process and must not expire. Details for additional accounts should be included in the Review Notes field.

Demo Account Password (optional)

The password for the full-access demo account.

Availability, Pricing, and Territory Rights

These properties describe where and when the app is available and at what price. They can be accessed through the Pricing menu on the App Details page. See Creating an iTunes Connect Record for an App and Viewing and Changing Your App’s Metadata.

Property

Description

Availability Date

The date when your app will be available for purchase on the store. If your app hasn’t been approved by Apple before this date, it’s posted to the store as soon as it’s been approved.

This date is a global date and applies to all relevant store territories and app versions. If you change this date, the new date applies to all versions of your app.

Price Tier

The level that determines both the customer price and your proceeds. Your proceeds are the price minus Apple’s commission and applicable taxes. If you choose a Price Tier other than Free, you must have a Paid Applications contract in place before you can sell the app.

You can view the pricing matrix by clicking Pricing on the App Details page for any app.

Price Tier Effective Date

The date when a new price tier will take effect on the store.

See Scheduling Price Tier Changes.

Price Tier End Date

The date that a price tier will no longer be in effect and will return to the previously set price tier.

See Scheduling Price Tier Changes.

Discount for Educational Institutions

If selected, this app is offered at a discount to educational institutions enrolled in the Apple Volume Purchase Program. The details of the discount are found in the latest Paid Application contract, which you must sign before this app will be available to education customers.

Custom B2B App (iOS only)

If this option is selected, this app is a custom B2B app that isn’t available in the public store. This option is available only if you’re creating an iTunes Connect record for the first version of the app and the record is still in an editable state.

For more information, see Configuring a Custom B2B App (Optional).

Territories

The individual countries or territories where the app is available to purchase or download. By default, your app is available in all territories the store currently supports and is added to new store territories.

iCloud Download Settings

The versions of an app that are available for existing customers to download from iCloud. You need to exclude app versions from iCloud if the version includes legal or usability issues. See Preventing App Versions from Appearing in iCloud.

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 Version Details for Each Territory.) There isn’t a separate WatchKit extension description but the version description, described in 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:

  • 1024 x 1024 pixels

  • 72 dpi, RGB, flattened, no transparency, no rounded corners

  • High-quality JPEG or PNG image file format

Screenshots

One screenshot is required. Up to four additional screenshots can be uploaded. Screenshots should suggest what the WatchKit extension does. Screenshot requirements are:

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG or PNG image file format

  • 312 x 390 pixels (only one orientation)

Game Center Properties

Game Center properties are described in Game Center Properties in Game Center Configuration Guide for iTunes Connect.

In-App Purchase Properties

In-App Purchase properties are described in Properties of In-App Purchase Metadata in In-App Purchase Configuration Guide for iTunes Connect.

Newsstand Properties

These properties describe the configuration information iTunes Connect collects for Newsstand-enabled apps and issues.

Property

Description

Default Cover Art

The default cover art used to represent your app on the store. The cover art must be a .png file, at least 72 dpi, a minimum of 1024 pixels on the long edge, and it must have an aspect ratio between 1:2 and 2:1. Also, the artwork must be flat with no rounded corners.

Subcategory (Optional)

The category that best describes the Newsstand product you’re adding. The primary category is Newsstand.

Published Date

The date you want this issue to be available on the store.

End Date

The date you want this issue to be removed from the store (it’s removed at the beginning of the day).

Issue ID

An internal identifier that isn’t visible on the store.

Summary

A summary of the issue that customers see on the store. The summary can be as long as 2000 bytes.

Issue Default Cover Art

The default cover art you specify is used to represent your app on the store when there are no issues available for your app on a given date or you don’t provide issue art for an issue.

The cover art must be a .png file, at least 72 dpi, with a minimum of 512 pixels on the long edge, and an aspect ratio between 1:2 and 2:1. The artwork must be flat, with no rounded corners.

Atom Feed URL

The URL for an atom feed that provides information for the store for Newsstand issues. The store processes the feed once a day, incorporating any new information.

For more information, read Newsstand Atom Feed Specification.

App Sandbox Information

These Mac App properties include notes for each temporary exception entitlement specified in the app build. If you are using App Sandbox entitlements, Apple needs information on each entitlement included in the app. For more information, see App Sandbox Design Guide.

Property

Description

Entitlement Key (required if the app uses entitlements)

Entitlement key corresponding to a temporary exception entitlement implemented in the app.

Usage Information (required if the app uses entitlements)

Information describing how to assess the entitlement and a description of the values in an array value used by the entitlement. If the entitlement works around a missing App Sandbox feature, include the issue number describing the exception.

In particular, the description should include:

  • How the entitlement can be assessed.

  • Why the entitlement is needed by the app.

  • What functionality this entitlement enables.

  • If the entitlement uses an array value, provide information on each value in the array.

  • If the entitlement works around a missing App Sandbox feature, include the issue number.

User Properties

User Roles

These properties describe the roles that control which iTunes Connect sections users have access to.

Role

Description

Admin

Gives the user access to all iTunes Connect sections. Users with an Admin role have the ability to create, delete, or modify existing iTunes Connect users and sandbox testers. They can manage testing of prerelease versions. They can request promo codes. The initial iTunes Connect user (team agent) is granted both Admin and Legal roles by default.

Legal

Gives the user access to all sections. This role is only available to the initial iTunes Connect user (team agent) and can’t be edited in iTunes Connect. This role allows the individual to enter into agreements with iTunes via iTunes Connect, request promo codes, transfer and delete apps, and manage TestFlight beta testing. To change your team agent, you must visit Member Center.

Finance

Gives the user access to Financial Reports, Agreements, Tax and Banking information, iAd App Network, Sales and Trends reports, and Analytics sections. Users with a Finance role can view users’ profiles but can edit only their own user information.

Technical

Gives the user access to the My Apps, Resources and Help, Users and Roles, and iAd App Network sections of iTunes Connect. Technical users can create sandbox testers and manage TestFlight beta testing. They can also be added as internal testers themselves. Users with a Technical role can view other users’ profiles but can edit only their own user information.

Sales

Gives the user access to the Sales and Trends, Analytics, Users and Roles, iAd App Network, and Contact Us sections. Users with a Sales role can view other users’ profiles but can edit only their own user information.

Assign this role to those in your organization who need access to reporting, marketing, and ad campaign information but not to app management or financial information.

Marketing

Gives the user access to the Contact Us section. Assign this role to the person on your team who manages your marketing materials and any promotional artwork.

Users with the Marketing role are contacted by the App Store team if an app is chosen to be featured in the App Store.

User Notifications

iTunes Connect users can be notified of events happening within iTunes Connect such as an app being approved for sale or a contract expiring. These properties describe the types of notification that can be enabled for an iTunes Connect user account.

Notification type

Description

Contract

Provides email alerts with contract status updates. Examples are contract expiration warnings or requests for more information from you to complete your contract setup.

Financial Report

Provides email alerts when finance reports are available for download in iTunes Connect.

App Status

Provides email alerts when an app changes state.

Payment

Provides email alerts when a payment to your bank is returned.