Managing Your App in iTunes Connect

You use iTunes Connect to release and maintain versions of your app throughout the lifetime of the product on the store. iTunes Connect is also a marketing and business web tool that team members use to sign contracts, set up tax and banking information, and obtain sales and finance reports. During development, you enter metadata about your app, app services that it uses, and any version information in iTunes Connect. This chapter teaches you additional tasks you perform in iTunes Connect during development and distribution through the store.

Initially, only the individual who joins the Apple Developer Program has access to iTunes Connect. Because iTunes Connect is primarily used to manage the business aspects of your app, and people performing those types of tasks are typically not developers, you can tightly control access to iTunes Connect separately from your Member Center account. For example, you can add nondeveloper iTunes Connect users and control access to metadata by assigning roles and privileges.

iTunes Connect users with admin and technical roles perform a number of tasks, explained in this chapter, in support of the development team and related to submitting your app to the store:

  1. Add iTunes Connect users to give other team members access to iTunes Connect.

  2. Create your app record so you can configure key app services, and upload your app.

  3. View the status of your app when you’re ready to submit it or waiting for approval.

  4. Change the availability date of an app version to release it.

  5. View analytics and customer reviews after your app is available.

  6. Create a new version of your app.

For complete documentation on using iTunes Connect, refer to iTunes Connect Developer Guide.

About iTunes Connect User Roles and Privileges

The person who enrolls in the developer program—called the team agent—manages access privileges to iTunes Connect. For example, changing the price of an app is a task you likely want to limit to a small number of people in your organization. Access to the iTunes Connect tool is configured separately and is designed to be more fine-grained than the access you set for team members. In iTunes Connect, each user can be assigned one or more roles; each role has different privileges. Table 12-1 describes the roles at a high level. (See Adding iTunes Connect Users and Viewing Roles to view details on each role.)

Table 12-1  iTunes Connect roles and responsibilities




The admin role grants access to all tasks in iTunes Connect except for agreements. A team agent is always assigned the admin role, and this access can’t be revoked without changing which person on the team acts as the team agent. An admin can assign iTunes Connect roles to other people on the team.


The legal role is automatically assigned to the team agent. The legal role allows the team agent to sign legal contracts and other agreements.


The technical role grants the ability to edit the app information stored in iTunes Connect and to manage test users for certain app services such as In-App Purchase. The technical role also grants permission to upload a build to iTunes Connect and submit an app to App Review.


The finance role grants access to financial reports, sales information, and app analytics. The finance role also authorizes the person to view contract, tax, and banking information.


The sales role grants access only to sales data and app analytics.


The marketing role grants access only to marketing data.

Accessing iTunes Connect

iTunes Connect is the repository for all store-related assets, including the builds of your app. You use iTunes Connect to market and distribute your app, check the status of your contracts, set up tax and banking information, get sales and finance reports, and manage your app’s metadata. You can give another set of users access to your iTunes Connect account. You access iTunes Connect from Member Center or by going directly to the iTunes Connect website.

To go to iTunes Connect from Member Center

  1. Sign in to Member Center.

  2. Click the icon or text for iTunes Connect.

  3. Enter your Apple ID and password, and click the arrow button.


Adding iTunes Connect Users and Viewing Roles

The team agent can add iTunes Connect users and change their roles. Before adding users, review the privileges for each role in iTunes Connect.

To view the privileges for each role

  1. Sign in to iTunes Connect.

  2. Click “Users and Roles.”

  3. Select an Apple ID from the list of users.

  4. Click Roles.

    A table appears showing the responsibilities for each role.


To add an iTunes Connect user or change user roles, read Setting Up User Accounts.

Creating an App Record

Certain app services require you to create an app record and enter the bundle ID using iTunes Connect during development. Later, you also need to create an app record in iTunes Connect to upload your app for distribution. When you’re ready to create your app record, read Creating an iTunes Connect Record for an App. To learn about other information you enter in iTunes Connect, and to view the versions and builds you upload to iTunes Connect, read Viewing and Changing Your App’s Metadata.

Adding a tvOS App to an iOS App Record

A watchOS and tvOS app can share the same app record as an iOS app. For watchOS apps, the app is included in the same Xcode project as the iOS app. For tvOS apps, the app shares the same bundle ID as the iOS app but must be uploaded in a separate Xcode project.

To add a tvOS app to an iOS app record

  1. In Xcode, create a separate project for the tvOS app.

  2. Select the tvOS target and set the bundle ID to the iOS app’s bundle ID.

  3. Set the version number and build string.

    The tvOS app can have different version and build numbers than the iOS app.

  4. On the iTunes Connect homepage, click My Apps.

  5. Click the iOS app you want to edit.

  6. In the left column, from the “Version or Platform” pop-up menu, choose tvOS.

    A version record for the tvOS app appears under tvOS App.

  7. To enter the version information, click the tvOS version record.

    Enter the information needed for the tvOS app on the right.

  8. In Xcode, upload the tvOS app to iTunes Connect.

    iTunes Connect adds the build to the tvOS version.

Viewing the Status of Your App

You can view the status of your app in iTunes Connect.

To view the status of your app

  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click My Apps.

  3. Locate the app you want to edit.


    The status of each version of your app appears below the icon and title.

  4. Click the large icon or app name to see more details.

For details on each status and how to view the status history, refer to Viewing and Changing Your App’s Status and Availability.

Changing the Availability Date of Your App

Use iTunes Connect to set a date when the app is available on the store. For example, you can choose a date that immediately releases the app to the store after it’s approved, or you can set a later date. Using a later availability date allows you to arrange other marketing activities around the launch of your app.

To set the availability date

  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click My Apps.

  3. Locate the app and click the large icon or app name.

  4. Click Pricing.

  5. Choose a date from the Availability Date pop-up menus.

  6. Optionally, edit the other fields in this form.

  7. Click Save.

Viewing Analytics

If you have the admin, finance, or sales role, view app analytics to track user app acquisition, usage, and monetization. On the iTunes Connect homepage, click App Analytics to view the data collected for each app. To learn more about understanding your analytics, read App Analytics User Guide.

Viewing Customer Reviews

You can view the most recent feedback from your users for an app that is available on the store.

To view customer reviews

  1. Sign in to iTunes Connect.

  2. On the iTunes Connect homepage, click My Apps.

  3. Locate the app, and click the large icon or app name.

  4. Click Reviews.


    The list of customer reviews appears.

  5. Select the review you want to view.

  6. Click Done.

Creating New Versions of Your App

To create new versions of your app, read Replacing Your App with a New Version.


In this chapter, you learned how to grant access to iTunes Connect and perform common iTunes Connect tasks performed by technical team members.