This appendix describes the metadata that iTunes Connect collects to present an app in the App Store or Mac App Store.
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.”
These properties identify an app in the iTunes Connect record.
|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
|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 ||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.”
|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.|
|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.|
|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.”|
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 properties include copyright information, categories, and ratings.
|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.
|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
|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 information, see 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.
|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:
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.
|Routing App Coverage File (optional)||Routing app coverage files are |
For information about the requirements of this file, see “Specifying the Geographic Coverage File Contents” in Location and Maps Programming Guide.
|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.
|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.
|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,
|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.
Include the entire URL, including the protocol.
|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:
|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:
|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:
|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:
App Review Contact Information
Contact Information properties provide information to Apple to support the app review process. This information never appears to users.
|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.
|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.|
|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.
|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:
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.
|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.|
These properties describe the roles that control which iTunes Connect modules users have access to.
|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.
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.
|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.|
These properties describe the configuration information iTunes Connect collects for Newsstand-enabled apps and issues.
|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
|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.