Managing Your Applications

Searching Your Apps

In iTunes Connect, you can view and edit apps that you have delivered to the App Store. The iTunes Connect Search feature lets you find content by name, Apple ID, app type, or status.

Your Manage Your Applications page shows you apps you have recently viewed, edited, or added. If your app has one version Ready for Sale and a new version created, you will see both version names in the Recent Activity section and in search results. If the app you want to work on isn’t displayed in the Recent Activity rows, you can use the Search feature to find the app.

To search your apps

1. Log in to iTunes Connect.

2. On the iTunes Connect homepage, click Manage Your Applications.

   

3. In the Search portion of the Manage Your Applications page, choose the criteria you want to search.

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

     

   • Apple ID: Enter the Apple ID of the app.

   • SKU: Enter the SKU of the app.

     

   • Status: Choose the status.

     

   • App Type (if enabled for both iOS and Mac apps): Select either iOS App or Mac OS X App.

     

4. Click Search.

5. In the Search Results, click the name of the app to view its information.

Checking the Status of an App

After searching for your app, click its name of the app to display the App Summary page. The App Summary page includes:

• Your app name

• SKU

• Bundle ID

• Apple ID

• App type

• Default language

• Both app versions (Current Version and New Version if applicable)

• Version number

• Status (see the table below for a description of the statuses)

• Date created by you in iTunes Connect

• Date released to the App Store (if at least one version is Ready For Sale)

• Link to View in App Store

• Resolution Center link (if the current/new version has been rejected)

• App Summary Page Action buttons

Here is an example of the App Summary Page:

Click the View Details button to see version details for a specific app version. The Version Details page that appears includes:

• Links to Crash Reports, Binary Details, Customer Reviews and Status History (each of these is described in more detail later in this chapter)

• A Resolution Center link (if the current/new version has been rejected)

• A Manage Localizations button

• A Promo Codes button (see “Requesting Promo Codes” to learn about promotional codes)

Click the Edit button next to App Information to edit the default language for your app.

There are seventeen status indicators that can appear for your app after submitting an app. If you need to see a description of any status in iTunes Connect, hold the pointer over the status to see a definition. To see which properties are locked when the app is not in an editable state, see Table 10-1 and Table 10-2.

Table 9-1  iTunes Connect app statuses

Status	Status Name	Description	Editable
	Prepare For Upload	Appears as the first status for your app. This status means that you should enter or edit metadata, screenshots, pricing, in-app purchases, Game Center, iAd network settings, and so on, to prepare your app for upload to the App Store.	X
	Waiting For Upload	Appears when you’ve completed entering your metadata and indicated that you are ready to submit your binary, however, you have not finished uploading your binary through Application Loader. Your app must be Waiting For Upload for you to be able to deliver your binary through Application Loader.	X
	Waiting For Review	Appears after you submit a new app or update and before the app is reviewed by Apple. This status means that your app has been added to the app review queue but has not yet started the review process. Because it takes time to review binaries, keep in mind that this state does not indicate that your app is currently being reviewed. While your app is waiting for review, you can: Reject your binary to remove it from the Apple review queue Edit certain app information	X
	In Review	Appears when Apple is currently reviewing your app before the app is rejected or approved. Note that it takes time to review binaries. We appreciate your patience and ask that you allow sufficient time for the processing of your app.
	Pending Contract	Appears when your app has been reviewed and is ready for sale but your contracts are not yet in effect. You can check the progress of your contracts in the Contracts, Tax & Banking module. See “Managing Contracts, Taxes, and Banking.”
	Waiting For Export Compliance	Appears when your CCATS file is in review with Export Compliance.	X
	Upload Received	Appears when your binary has been received through Application Loader but has not yet completed processing into the iTunes Connect system. If your app has been in the Upload Received state for more than 24 hours, you should contact iTunes Connect Support through the iTunes Connect Contact Us module.	X
	Pending Developer Release	Appears when your app version has been approved by Apple and you have chosen to set your version release control. Release it to the App Store when you are ready. To release your app to the App Store, click the Release This Version button on the app’s Version Details page within Manage Your Applications.
	Processing for App Store	Appears when your binary is being processed and will be ready for sale within 24 hours.
	Pending Apple Release	Appears when your app version will be held by Apple until the corresponding Apple iOS or OS version is released to the public.
	Ready For Sale	Appears after the binary has been approved and the app is posted to the App Store. When your app is in this state, you have the option to remove it from the store by going to the “Rights and Pricing” page and removing all App Store territories. See “Removing an App from Sale.”
	Rejected	Appears when the binary has not passed review. You receive a communication from App Review in the Resolution Center regarding the reason for the rejection.	X
	Metadata Rejected	Appears when specific metadata items aside from your binary have not passed review. To resolve the issue, edit the metadata in iTunes Connect and your existing binary is then reused for the review process. You receive a communication from App Review in the Resolution Center regarding the reason for the metadata rejection.	X
	Removed From Sale	Appears when your app has been removed from the App Store.
	Developer Rejected	Appears when you’ve rejected the binary from the review process. Choosing the Developer Rejected status removes your app from the review queue. After you resubmit your binary, the app review process starts over from the beginning.	X
	Developer Removed From Sale	Appears when you’ve removed the app from the App Store. See “Removing an App from Sale” and “Putting an App Back on Sale.”
	Invalid Binary	Appears when your binary has been received through Application Loader but did not meet all requirements for upload. You receive an email detailing the issue with your binary and showing how to resolve it. To resend the resolved binary, go into iTunes Connect and click Ready to Upload Binary again. This action sets your app back to the Waiting For Upload state so that you can resend the binary through Application Loader.	X
	Missing Screenshot	Available for iOS apps only. Appears when your app is missing a required screenshot for iPhone and iPod touch or iPad for your default language app or for your added localizations. At least one screenshot is required for both iPhone and iPod touch, and for iPad if you are submitting a universal app. Click the number next to the status to view a list of the territories in which a screenshot is missing.	X

Viewing Rejection Details in the Resolution Center

If your app does not pass review and is rejected, you receive a communication from App Review in the Resolution Center regarding the reason for the rejection. The Resolution Center can be accessed from both the App Summary and the Version Details page.

If your app has been rejected, you see a link to the Resolution Center displayed at the top of the page.

Click Resolution Center to view details regarding your app rejection. The Resolution Center displays information about your app rejection from App Review, and you can respond asking for clarification if necessary. You can see any specific App Review Guidelines that caused your app to be rejected, in addition to any further information provided by App Review.

You can correspond with App Review about your rejected binary until you resubmit it for review. You can also send attachments, such as screenshots, back to App Review. After you resubmit your binary for review, you can no longer communicate with App Review through the Resolution Center.

If your app has been rejected because of its metadata, you can resolve the metadata issues that have been identified by the App Review team without having to recompile and resubmit a new binary for review. Edit the metadata in iTunes Connect, and your existing binary will be reused for the review process.

Viewing Status History

The Status History link on the Version Details page lists all state changes for your app, provides a time and date stamp for the change, and notes whether the change was initiated by Apple or by one of your iTunes Connect users. This information helps you track your app throughout the review process and helps you diagnose availability issues. For example, if you notice that your app is in the “Developer Removed from Sale” status and you know that you didn’t remove it from sale, you can check your status history to see which iTunes Connect user removed the app.

Viewing Binary Details

On the Version Details page is a link to your Binary Details page. Clicking Binary Details to take you to that page.

The Binary Details page contains detailed binary information and identifiers that are extremely valuable when communicating with Apple support teams about your app. The Binary Details page is also where you can reject the binary you have submitted. The Apple ID of your app should always be referenced when seeking technical support with Apple to help speed up response time and assist with troubleshooting efforts. The binary details shown vary based on app type (iOS App or Mac OS X App).

Viewing Crash Reports

Application crash reports are available in iTunes Connect for you to view the most frequent crashes that your customers are encountering for your iOS or Mac apps. You can find crash logs specific to a version of your app by clicking the Crash Reports link from your Version Details page in iTunes Connect.

If you do not see this button or link, it is because crash logs are not available for this app at that given time—either because your app has not been on the App Store for a long enough period of time to generate crash logs or because Apple has not received any crash information from your customers.

Fetching New Crash Reports

You can request crash logs on demand by clicking the Refresh Now link to retrieve any new available logs. You will also be able to see the last requested date of your crash reports and whether the logs are current or not:

The reports show the crash logs for the most recently approved version of each app. You can view reports by iOS or OS X version.

The crash report page has a tab for each OS release that has an available report. Reports are always available for the most recent shipping iOS or OS X release. From time to time, at Apple’s discretion, developer seed builds from unreleased versions of iOS or OS X may also be shown.

Viewing Customer Reviews

Customer reviews are also available in iTunes Connect for you to view the most recent feedback from your users. You can find customer reviews specific to a version of your app by clicking the Customer Reviews link from your Version Details page in iTunes Connect.

If you do not see this link, customer reviews are not available for this version of your app. This could be because this version of your app does not have any customer reviews or because it is not yet available on iTunes.

Rejecting Your Binary

You can reject the binary you have submitted if its status is any of the following: Missing Screenshot (iOS only), Waiting for Export Compliance, Waiting For Review, In Review, Pending Developer Release, or Pending Apple Release. Click the Reject Binary button on the Binary Details page. This action removes your binary from the review queue. You can then submit another update through Application Loader after you move your app back to the Waiting For Upload state in iTunes Connect. If you reject your binary, your app’s status changes to Developer Rejected. When you resubmit your binary, the review process starts over from the beginning.

Removing an App from Sale

Since rights and pricing settings are app-level settings, when you choose to remove all App Store territory settings for an app, you remove the entire app from the App Store—not just a specific version.

To remove your app from sale on the App Store

1. On your App Summary page, click the “Rights and Pricing” button.

2. On the page that appears, click the link to view specific stores.

3. Click Deselect All to deselect all App Store territories.

4. Click the Save Changes button.

After removing all assigned territory checkboxes from your app in the rights and pricing section, the status changes to “Developer Removed from Sale.” Within 24 hours, your app will not be seen on the App Store.

Putting an App Back on Sale

To sell an app you have previously removed from sale, you must put it back on sale within the rights and pricing section.

To put your app back on sale

1. On your App Summary page, click the “Rights and Pricing” button.

2. On the page that appears, click the link to view specific stores.

3. Click the Select All button to select all App Store territories worldwide or select individual territories where you want to sell your app.

4. Click the Save Changes button.

After indicating the App Store territories in which you want to put your app back on sale, your status is no longer "Developer Removed from Sale.” Your app will reappears in the App Store within 24 hours as long as your app status is “Ready for Sale.”

Deleting an App

If you have created an app in iTunes Connect that you no longer need to see or manage, you can delete it from your iTunes Connect view.

If you are selling your app to another developer for their own distribution and need to remove it from your iTunes Connect account, we recommend that you click Delete Application so that the app’s name will be freed for their use.

You cannot delete an app that is Ready For Sale. Before you can click Delete Application, you need to remove your app from sale.

You can delete your app when it is in one of the following states:

Prepare for Upload

Waiting for Upload

Invalid Binary

Developer Rejected

Rejected

Metadata Rejected

Developer Removed from Sale

Removed from Sale