iTunes Connect: submit and manage your apps

iTunes Connect is a suite of web-based tools created for developers to submit and manage their apps for sale via the App Store. In iTunes Connect you will be able to check the status of your contracts, manage iTunes Connect and test users, obtain sales and finance reports, view app crash logs, request promotional codes, setup iAd Network and Game Center preferences, as well as add or manage app metadata, binaries, and In-App Purchases.

Before you can use iTunes Connect, you must have a user account. When you enrolled in the Apple Developer Program, you created an Apple ID and password. This account is set up as your company’s Apple Developer Program Team Agent and has been given initial access to iTunes Connect. This account has full privileges. You use this account to log in, and you can later create other users.

Asset Specifications

To submit your app through iTunes Connect and get it posted on the App Store successfully, make sure you have the following:

  • App binary
    • iOS binaries: Includes 57px and an optional 114px hi-res icon for iPhone and iPod touch or a 50px and 72px icon for iPad
    • Mac OS X binaries: Includes at least a 512x512px and 128x128px icon
  • Large 512px icon for use on the desktop App Store (for iOS apps only)
  • Screenshot(s)
  • Contract information
  • Export compliance information
  • App metadata

Small App Icons

  • iPhone and iPod touch: If you are uploading an app to run on iPhone and iPod touch, the binary must include an icon that is 57×57 pixels, which will be displayed on the home screen and the App Store when viewed from the iPod touch and iPhone. You can also optionally include a hi-res icon that is 114×114 pixels to take advantage of the Retina display on iPhone 4
  • iPad: If you are uploading an app to run on iPad, the binary must include two icons: one that is 50×50 pixels and one that is 72×72 pixels, which will be displayed on the iPad home screen and the App Store when viewed on the iPad
  • Mac OS X: If you are uploading a Mac OS X app, the binary must include a 512×512 pixel and 128×128 pixel icon

Large App Icon

The large icon requirements apply to both iPhone / iPod touch apps as well as iPad. The large icon for Mac OS X apps will be included in the binary, while the large icon for iOS apps will be provided separately. This large icon will be displayed for your app on the desktop App Store and, if necessary, will be used to feature your app on the App Store. To be considered for a feature on the App Store, you must provide attractive, original icons.

  • 512px square (do not scale-up smaller artwork, as this could appear pixelated and blurry)
  • 72ppi, RGB, flattened, no transparency
  • High quality JPEG,TIFF, or PNG image file format. ZIP-compressed TIFF files are not acceptable

All icons for iOS apps, small and large, must meet the following requirements respectively:

Large App Icon

Screenshots for iPhone / iPod touch and iPad apps

The first screenshot you upload in iTunes Connect will be used as the main screenshot visible on your app product page on the desktop App Store, and the device App Store when viewed on the iPhone, iPod touch and/or iPad. For best results, do not include the iPhone or iPad status bar in your screenshots. See the online documentation for the requirements. Short list:

  • 320×460 portrait (without status bar) minimum
  • 320×480 portrait (full screen) maximum
  • 640×920 hi-res portrait (without status bar) minimum
  • 640×960 hi-res portrait (full screen) maximum
  • 480×300 landscape (without status bar) minimum
  • 480×320 landscape (full screen) maximum
  • 920×600 hi-res landscape (without status bar) minimum
  • 920×640 hi-res landscape (full screen) maximum
  • 72ppi, RGB, flattened, no transparency
  • High quality JPEG, TIFF or PNG image file format. ZIP-compressed TIFF files are not acceptable

iPad Screenshots (required if app runs on iPad)

If your binary indicates that your app will run on iPad, you are required to upload at least one iPad screenshot. Your iPad screenshots will appear on the App Store on the iPad only. Up to four additional optional screenshots can be displayed along with this first screenshot on the app product page on the iPad App Store. For best results, do not include the iPad status bar in your screenshots and follow these requirements:

  • 1004×768 landscape (full screen) minimum
  • 1024×768 landscape (without status bar) maximum
  • 748×1024 portrait (full screen) minimum
  • 768×1024 portrait (without status bar) maximum
  • 72ppi, RGB, flattened, no transparency
  • High quality JPEG, TIFF or PNG image file format. ZIP-compressed TIFF files are not acceptable
Device dimensions
Device dimensions

Settings Default page

The first time you choose to add a new app in iTunes Connect, you will be presented with the Settings Defaults page. This page allows you to set your defaults for each new app you add to your developer account for distribution on the App Store.

Primary Language is the language in which you will be uploading your metadata. For example, if you select Dutch from the drop down, we expect that you will be uploading your metadata and assets in Dutch. Subsequently, your metadata and assets entered in Dutch will display in all App Stores worldwide unless you specify individual localizations. Your primary language applies to all apps delivered under your developer account. Your primary language and company name cannot be edited once submitted on this page.

Company Name – the company name that will be displayed on the App Store. For example, “Cyberinteractive” seen above in iTunes Connect, refers directly to the name that will appear in the upper left hand corner of your product page in the App Store. Your company name is a key piece of organizational metadata for your apps on the App Store because when customers click on this name, they will be led to a page that contains all currently live apps sent through your developer account.

Preparing App for Binary Upload

To make an app available for purchase in the App Store, you must first enter information about it, include pricing and localization thus fully preparing your app for binary upload. You will then use Application Loader to submit your binary to Apple. To add an app:

  • Log into iTunes Connect
  • On the Home page, click Manage Your Applications
  • On the Manage Your Application page, click Add New App
    • If you have contracts in effect for both iOS and Mac OS X apps, you will be asked to select your app type
  • The following sections break down the steps involved in adding an app

Configuring Your Project for App Store Submission

To submit your app for publication on the App Store, you need to build the app using your team’s distribution code signing identity. To configure your project to facilitate the building of distribution-identity–signed archives of your app:

  • In your project, duplicate the Release build configuration and name the duplicate “AppStore”
  • Set the Code Signing Identity build setting to your team’s distribution code signing identity through the app’s distribution provisioning profile for the AppStore build configuration
  • In the target, delete the Validate Build Product build setting specification for the Release build configuration
  • “Managing Schemes” the scheme that builds your app and name the duplicate “<App_Name>-AppStore”
  • In the AppStore scheme, set the build configuration for the Archive action to AppStore
Signing identity

App Information Entry

The Application Information page is where you will supply all of your initial app level information (in your primary language) for the new app you are creating. If your iOS app requires a specific device capability (i.e. telephony, GPS, accelerometer, etc.) to function properly, you will need to be sure to code this into your binary. The App Store requires this information so that it can generate a list of requirements for user devices and prevent users from downloading applications that they cannot run. It is not necessary to specify required device capabilities for Mac OS X apps.

If you choose a Bundle ID with a wildcard in it, you will need to enter a Bundle ID Suffix for this app to make your Bundle ID explicit. You are required to have an explicit Bundle ID for distribution on the App Store. Your explicit Bundle ID must be entered as your Bundle Identifier in your Xcode project. Bundle IDs are app-type specific (either iOS or Mac OS X). The same Bundle ID cannot be used for both iOS and Mac OS X apps.

App Name

The name of the app using no more than 255 characters and no less than 2 characters. Keep the following in mind when choosing the name:

  • Choose a name that is distinct and appropriate
  • For best results on the application product pages on the desktop App Store, use no more than 70 characters. For the device App Store, use no more than 35 characters
  • Do not use an app name that is substantially similar to an existing app name by adding or removing spaces, exclamation points or other characters
  • Do not include a description of your app in the app name
  • Once you create your app and assign your app name, you will have 120 days to delivery a binary or your app will be deleted from iTunes Connect so your name is freed up for use by the developer community
  • Once submitted, your application name can be changed only when your app is in an Editable State

SKU

  • The unique UTF-8 alphanumeric identifier for the app
  • The SKU is any alphanumeric sequence of letters and numbers you’d like to use to be uniquely identified in our system. You are free to create any string of UTF-8 letters and numbers, as long as it is unique to your developer account
  • Your SKU Number is not editable after submitting your metadata
  • This SKU is internal only and is not seen by customers at any time

Bundle Identifier

  • An identifier used by iOS and Mac OS X to recognize any future updates to your app
  • Your Bundle ID must be registered with Apple and unique to your app
  • Bundle IDs are app-type specific (either iOS or Mac OS X). The same Bundle ID cannot be used for both iOS and Mac OS X apps
  • An app’s Bundle Identifier is only editable if you have not yet submitted a binary for review and your app is not using Game Center or iAd

Supplying Version Information

The Version Information page is where you will supply all the metadata (in your primary language) associated with this specific version of your app. This information will appear to the user on your app product page on the device (for iOS apps only) and desktop App Store (for both iOS and Mac OS X apps). Mac OS X apps will only display on the Mac App Store.

Version Number

  • The unique version number of the app. Use typical software versioning conventions (for example, “1.0 or 1.0.1 or 1.1”)
  • Do not include words such as “build” , “version” or “beta” in your version number

Description

  • A detailed description of the app version itself, no longer than 4000 characters and no less than 10 characters
  • Use fewer than 580 characters so customers can view your entire description without clicking the …More button on the App Store
  • HTML isn’t allowed; descriptions must be in plain text and only line breaks will be respected
  • This is the description that customers read to help them make their purchase decision and is therefore a key piece of marketing text

Primary and Secondary Category

  • The Primary category is the one that best describes your application, and is the category under which your application will be listed
  • The Secondary category will also provide an additional search term which may help users find your application. The Secondary category is not required, however it is recommended since it will be used as a fall-back if the first is not available
  • Your application will not be listed on the category page for the application’s Secondary category on the App Store. The Secondary category is for use with the App Store Browse function only

Keywords

  • One or more keywords that describe your app. Keywords are used to help customers search the App Store effectively. Your application will be searchable by application name, company name, and keywords
  • Once submitted, keywords can only be changed by updating your binary or when your application status is Rejected or Developer Rejected
  • Keywords can be single words or phrases and the text field is limited to 100 characters but must be more than 2 characters.
  • Separate multiple keywords with commas for best results

Copyright

The name of the person or entity that owns the exclusive rights to the app you are adding. For example, “2012 Test Inc.” Do not include a copyright symbol. We will include it for you so it appears correctly on the App Store.

Contact Email Address

An email address where Apple can contact you if there are problems with your app.

Support URL

The support website you plan to provide for users that have questions regarding the app. This is required, and will appear on the app product page on the App Store. Your Support URL must lead to actual contact information for support so
that your customers can contact you regarding app issues, general feedback, or feature enhancement requests.

App URL

The website for users to get more information about the app. This field is not required but is highly recommended for a good customer experience. If provided, this will appear on the app product page on the App Store.

Review Notes

Use this field to give demo account information with full access to Apple for purposes of reviewing your app. If your app requires specific settings, user registrations, or account information prior to submission to the App Store, be sure to include that information in this field.
If your app delivers streaming video over the cellular network, a test stream URL must be entered in this field.

This is a text field visible only to the App Review team, so the information entered in this field will not appear on the App Store. You can also include general instructions or other relevant information about your app that you think would be useful for the review process.

Uploads

The Uploads section of the Version Information page is where you will upload all of your assets – your large app icon for iOS apps, your first screenshot for iPhone/iPod touch, iPad or Mac OS X, and any additional screenshots. All assets, except for the additional screenshots, are required based on the device families set in your app binary.

Final step

Once you have completed all information on the Version Details page, click . You will then be taken to your App Summary Page to view your created app in it’s first state, Prepare for Upload.

Ready to Upload Your Binary

Once you have completed the app upload preparation steps outlined above, you will need to answer some more questions dependent upon the nature of your binary. To begin the Ready to Upload Binary flow:

  • From your Version Details page, click on the Ready to Upload Binary button
  • In order to be ready to deliver your binary through Application Loader, you will need to answer questions about Export Compliance and also indicate if you are updating your app due to a legal issue
  • Once you complete Export Compliance, if your version is an update to an existing app, you will continue to the Version Release Control page. If your version is a new app, you will be led straight to the Application Loader Instructional Page to learn how to deliver your app through Application Loader
  • Once you complete Export Compliance, indicate any legal issue and your Version Release Control settings, if applicable, your app status will change to Waiting For Upload which indicates to the Application Loader software that your app is ready to receive a binary delivery

Version Release Control

You can determine when your app updates go live on the App Store. With the Version Release Control, you can control when a version of your app goes live, rather than have the version go live as soon as it is approved by App Review.
You will be presented with the Version Release Control option as part of your Ready to Upload Binary questions.

If you choose to automatically release your app update, it will go live as soon as it is approved by Apple (pending your set availability date). If you choose to use the Version Release Control, your app status will change to Pending Developer Release once it is approved by App Review, indicating that you can release it to the App Store whenever you are ready.

When you’re ready for your app update to go live on the App Store, you will be responsible for releasing your app version to the App Store:

  • On the iTunes Connect Home page, click Manage Your Applications
  • Locate your app and click on your large icon to view your App Summary page
  • You will see that there is an action indicator for your new version where you set the Version Release Control indicating that the version is held for developer release
  • Click View Details for that version
  • Click Release This Version button

Editing and Updating App Information

Once your app has gone through the review process, the status changes to Ready for Sale and the app is available for sale on the App Store. Once it is for sale, and in some cases, before it is Ready for Sale, you can make changes to your app by:

  • Editing version level information, including version metadata, ratings, large icon, screenshots and localizations
  • Editing app level information, including rights and pricing, Game Center and iAd Network settings, and In-App Purchases
  • Creating a new version of your app to submit a binary update (if your version is Ready for Sale)

Editing Version Information

Editing your version’s information means you will be editing a specific version’s metadata, the ratings the large icon, the screenshots, and / or the localizations, all associated with that version of your app. Changes you make to Unlocked version information go live immediately (expect 24 hours for a full refresh of the change on the App Store), so make sure you proofread carefully. To edit version information:

  • On the iTunes Connect Home page, click Manage Your Applications
  • Locate the app you want to edit and click on the large icon or app name
  • Click View Details for the version of your app.
  • You will see an Edit button next to the Version
  • Information, Metadata, Uploads and EULA sections allowing you to edit the respective section’s information

You will only be permitted to edit Locked version information when your app is in an Editable state. Clicking on Edit will allow you to see which version information can be edited depending on your app’s state. If none of your version information is editable, no Edit button will be present for that section.

Editable information table

Editable information table
Editable information table

Device Compatibility Matrix

Device Compatibility Matrix
Device Compatibility Matrix

 

 

 


Leave a Reply