Viewing and Changing Your App’s Metadata

After you create an iTunes Connect record for an app, the app appears in the My Apps section in iTunes Connect. You open the app record from here whenever you need to access the app information.

In addition to the metadata and configuration options you provide for the app, iTunes Connect organizes app platform information (from the app build) and customer experience information (from the store) in the app record. This chapter describes how you access the information and how and when you can update it. For information on updating the build for an app, see Replacing Your App with a New Version.

To manage existing apps, you must be signed in as a user with an Admin or Technical role.

Viewing App Information

You can view the app metadata as entered in iTunes Connect and as it will appear in the store for a given language. After you upload an app build, you can view the information iTunes Connect reads from the build, including the binary size.

Viewing an App

Only the team agent or users with Admin or Technical roles can view apps in iTunes Connect. If your user account doesn’t have the appropriate access, you won’t see the My Apps section on the iTunes Connect homepage. To be able to add an app, contact a user in your organization with an Admin role to give you access. Find a user with an Admin role as described in Viewing, Editing, and Deleting iTunes Connect Users.

To view the iTunes Connect record for an app

  1. As an iTunes Connect user with an Admin or Technical role, sign in to iTunes Connect.

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

  3. A list of all apps appears. Click on one of the icons at the top-right to choose whether to see the apps presented in a list or in a grid with large icons.


    Select the app you’re interested in. If you don’t see the app you’re looking for, find it by doing one of the following:

    • Use the Search box as described in Searching for Apps.

    • Use the Types and Statuses menus to narrow down the number of apps listed.


The App Details page shows both version-level and app-level information.

To open the information for a specific version, click the tab for that Version Number.

Versions shows the iTunes Connect metadata for the version in section, starting with the information that can be localized, followed by additional sections of version-specific configuration information.

Searching for Apps

If you don’t see the app you are looking for on the My Apps page, you can search for the app using a variety of criteria.

To search for an app

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

  2. To filter the list by app type or status, use the pull-downs to the right of the Search box.

  3. In the Search box, choose the criteria you want to use to search for an app. The view starts filtering the list of apps as soon as you start typing.

    • Name. Choose the search criteria and enter the name or a portion of the name.

    • Apple ID. Enter the Apple ID of the app. This value must match exactly to return an app.

    • SKU. Enter the SKU of the app.

    If no apps are listed, then the criteria you typed do not match any apps.

In the search results, clicking the name of an app opens the App Details page.

Viewing Version Details for Each Territory

Use the Version Summary to review the metadata for each store territory.

To open the Version Summary page

  1. Click Version Summary at the bottom of the Versions pane, in the Additional Information section.

  2. Review the app information as it would appear in the store for a given territory.

    Choose a territory from the Territory menu.

Viewing Build Details

After you upload the app build to iTunes Connect, iTunes Connect reads information from the build to present it properly in the store. You can view a summary of the build information on Prerelease on the App Details page. You can see build details by clicking the the build number.

To view build details

  1. Click Prerelease for a summary of build information.The build information and identifiers are valuable when communicating with Apple support teams about your app.

  2. Click the build number that you would like to view. The build details will be displayed on Build Details when you inspect the build number.

From Prerelease, you can do the following.

  • In Builds, see the list of build numbers you have uploaded and disable availability in TestFlight beta testing.

  • In the Internal Testers pane, see the names of your internal testers along with the build number they are testing.

  • In the External Testers pane, see the names of your external testers and the build number they are testing.

  • Stop TestFlight beta testing by flipping the Available in TestFlight switch.

You can view further build details by clicking the build number on Prerelease. The build details shown vary based on whether the app is an iOS app or a Mac app.

Viewing an App in the Store

If your app includes a version that’s Ready for Sale, you can open the store page for the app directly from iTunes Connect.

To view an app in the store

  1. Open the App Details page for the app, as described in Creating an iTunes Connect Record for an App.

  2. On the More menu, click View on App Store.


Changing Store Content While an App Is Live

You can change the following app metadata while an app’s version has Ready for Sale status:

The editable metadata that appear in the Version Information section can be changed for both the primary language as well as additional languages in which your app is already localized. To edit metadata for localizations other than the primary, first select the language from the Language menu.


To edit the metadata for a Ready for Sale app

  1. Make sure you have only one browser window or tab open with iTunes Connect.

  2. Open the App Details page for the app, as described in Creating an iTunes Connect Record for an App.

  3. On Versions, select the version of your app that has Ready for Sale status.

  4. Edit the metadata you want to update in the store. Only properties you can change are editable in each section. Valid properties are specified in detail in iTunes Connect App Properties.

  5. After you’ve made the changes you want, click Save.

You can also change the primary language:

To update the primary language of a live app

  1. Select the More menu.

  2. Select About This App.

  3. Select a language from the list of languages for which the app has been localized.

In addition to store metadata, you can also change the territories in which the app is available and app pricing, as described in Scheduling Price Tier Changes. You can update and add additional In-App Purchase products for an app that is Ready for Sale, as described in Creating In-App Purchase Products in In-App Purchase Configuration Guide for iTunes Connect.

Changes you make to this information are posted immediately. Expect 24 hours for a full refresh of the changes on the store.

If you’re changing other information that isn’t listed as editable, you need to create a new app version and resubmit it. See Replacing Your App with a New Version.

If the app version doesn’t have the Ready for Sale status, check to see whether the status allows any editing (see About App Statuses). Refer to iTunes Connect App Properties for which properties can be changed.