iTunes Connect App Properties

This appendix describes the metadata that iTunes Connect collects to present an app in the App Store or Mac App Store.

../Art/appstore_metadata_2x.png

App-Level Properties

These properties apply to all versions of an app. Changes you make to app-level 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.”

App Information

These properties identify an app in the iTunes Connect record.

Property

Description

Editable

Default 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 default language only applies to store information. The languages your app supports are set in your binary.

Can be changed anytime to other languages for which you’ve provided localized metadata.

App Name

The 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, assuming single-byte characters.

Can’t be edited after the app is approved. Before the app is approved, change the app name as part of localized text, described in “Metadata and Upload.”

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.

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) needs to exactly match the bundle identifier in your Xcode project Info.plist file.

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 number that Apple assigns to the app.

Can’t be edited.

Availability, Pricing, and Territory Rights

These properties describe where and when the app is available and at what price. Note that the price tier start and end dates are only available after the app’s iTunes Connect record is created. 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 on the Rights and Pricing page available from the App Summary page for any app.

Price Tier Effective Date

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

See “To release a Pending Developer Release version to the store.”

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 “To release a Pending Developer Release version to the store.”

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 agreement, 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.”

Version-Level Properties

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

Version-level 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 version-level properties are posted immediately (expect 24 hours for a full refresh of the change on the store). See also “About App Statuses.”

Version Information

Version information properties include copyright information, categories, and ratings.

Property

Description

Editable

Version Number (required)

The version number of the app you’re adding. Numbering should follow typical software versioning conventions (for example, 1.0, 1.0.1, 1.1).

Important: Make sure the version number matches the version number set in the bundle. If these don’t match, upload errors for later updates might occur.

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

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. See also “Categories: Get in the Right Place.”

For Mac apps, you must define a category in the Info.plist file of your app binary 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 binary 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.

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.

See “Made for Kids: Target Kid-Friendly Apps.”

Locked

Large 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

  • High-quality JPEG, TIFF, or PNG image file format. ZIP-compressed TIFF files can’t be used.

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 binary is used on the device Home screen when installed.

Locked

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, see “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 available in the Version Summary report, as described in “Reviewing Your Version Summary.”

Read-Only

Metadata and Upload

Metadata and upload properties include the localizable text and images that appear in the store.

Note that the What’s New in This Version property is only available for app versions after the first version.

Property

Description

Editable

Language

The language of this metadata.

Locked

App 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, assuming single-byte characters.

Locked

Description (required)

A localized description of the app, detailing features and functionality. Descriptions are limited to 4000 single-byte characters. 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 single-byte characters.

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

3.5-Inch Retina Display Screenshots (required)

One screenshot is required. Up to four additional screenshots can be uploaded. Screenshots appear on the store in the order they were uploaded in iTunes Connect. Only screenshots for Newsstand apps can be reordered after they’ve been uploaded.

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

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG, TIFF, 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 if app runs on 4-inch Retina display)

If your binary indicates that your app runs on the 4-inch Retina display, you’re required to upload at least one of these screenshots.

Up to four additional optional screenshots can be uploaded. Screenshots appear on the store in the order they were uploaded in iTunes Connect. Only screenshots for Newsstand apps can be reordered after they’ve been uploaded.

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

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG, TIFF, 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

iPad Screenshots (required if app runs on iPad)

If your binary 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. Only screenshots for Newsstand apps can be reordered after they’ve been uploaded.

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

  • 72 dpi, RGB, flattened, no transparency

  • High-quality JPEG, TIFF, 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 OS X App 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, TIFF, 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 Review Contact 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.

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

Username (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.

Password (optional)

The password for the full-access demo account.

App Store 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 Sandbox Entitlement Usage Information

These Mac App properties include notes for each temporary exception entitlement specified in the app binary. 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.

EULA (End User License Agreement)

Apple provides a standard EULA 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, see 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, see Licensed Application End User License Agreement.

Property

Description

EULA (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 EULA text can include multiple languages.

Countries

The countries in which a custom EULA applies.

User Properties

User Roles

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

Role

Description

Admin

Gives the user access to all iTunes Connect modules. Users with an Admin role have the ability to create, delete, or modify existing iTunes Connect users and test users. The initial iTunes Connect user (team agent) is granted both an Admin and a Legal role by default.

Legal

Gives the user access to all modules. 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 and to request promo codes. To change your team agent, you must visit Member Center.

Finance

Gives the user access to Financial Reports, Contracts, Tax and Banking Information, iAd App Network, and Sales/Trend Reports modules. Users with a Finance role can view users’ profiles but can edit only their own user information.

Technical

Gives the user access to Manage Your Apps, Contact Us, Manage Users, and iAd App Network modules. Technical users can create test users. 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/Trend Reports, Manage Users, iAd App Network, and Contact Us modules. 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 module. 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 notifications 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.

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 characters, assuming single-byte characters.

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, see Newsstand Atom Feed Specification.

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.