Viewing and Changing Your App’s Status and Availability

When your app is available on the store, its status is Ready for Sale, as shown by a green status indicator ../Art/status_green_2x.png . Any other status means that your app is not live on the store. You may have deliberately removed the app from sale, such as if you’re waiting to release the app to correspond to a marketing campaign. This chapter describes how to control when and in which store territories an app is available, and at what price.

If you haven’t deliberately removed the app from sale, you should review the app status to understand why the app isn’t on the store. This chapter describes the possible app statuses and how to resolve issues that prevent an app from being available on the store.

If you want to change the text or images used to display the app on the store, see Viewing and Changing Your App’s Metadata instead.

About App Statuses

Wherever app versions are listed in iTunes Connect, you’ll see the version’s status (such as Ready for Sale or Prepare for Submission) or a status indicator (such as ../Art/status_green_2x.png , ../Art/status_yellow_2x.png , or ../Art/status_red_2x.png ). The status tells you immediately whether your app needs attention:

The version status text, described in Table 12-1, helps you understand what may be preventing your app from being available on the store.

The descriptions of app version statuses in the table include whether you can edit the iTunes Connect metadata when the app version is in that status.

Table 12-1  App version statuses


Status name




Prepare for Submission

You’ve created an iTunes Connect record for the app, but you aren’t ready to submit the app for review. It’s likely that you’re still configuring metadata, screenshots, app preview, pricing, In-App Purchase, Game Center, the iAd App Network settings, and so forth.



Waiting For Review

You’ve submitted a new app or updated version and it’s been received by Apple, but Apple hasn’t started reviewing the app.

While your app is waiting for review, you can:



In Review

Apple is reviewing your app. Because every app submitted is different, there’s no set review time.

You can remove your build from the review queue by rejecting the build. See Removing a Build from Review.


Pending Contract

Your app is reviewed and ready for sale but your contracts aren’t yet in effect.

Check the progress of your contracts in the Agreements, Tax & Banking section. See Viewing Contracts and Contract Status.


Waiting For Export Compliance

Your app is reviewed and ready for sale, but your CCATS file is in review with Export Compliance.



Pending Developer Release

Your app version has been approved by Apple and is waiting on you to release it.

Release the version to the store when you’re ready. See Specifying When App Versions Are Released.


Processing for App Store

Your build is being processed and will be ready for sale within 24 hours.


Pending Apple Release

Apple is holding your app version until the corresponding Apple iOS or OS version is released to the public.

If you think an app should be released on existing iOS or OS versions, review the deployment target set in your app build. If you rebuild your app build with a different deployment target, reject the build for this version and submit the new version.


Ready for Sale

Apple has approved the app version and posted it to the store.

Changes available in this status are:



Apple rejected the build. iTunes Connect users with an Admin or Technical role are notified with what caused the rejection.

See Viewing Resolution Center Communications.



Metadata Rejected

Metadata items other than your build haven’t passed review. See Viewing Resolution Center Communications.

To resolve the issue, edit the metadata in iTunes Connect. When you’ve resolved the issue, submit the app for review again.



Removed From Sale

Your app has been removed from the store.

If your app is at risk of being removed from the store, Apple will contact you to try to resolve the issues before removing your app.


Developer Rejected

You’ve rejected the build from the review process, removing it from the review queue.

When you’re ready, resubmit your build or submit a new build. See Removing a Build from Review.



Developer Removed From Sale

You’ve removed the app from the store. See Removing an App from Sale.


Invalid Binary

Apple received your build, but it didn’t meet all the upload requirements.

Resolve any issues in the build. On Versions, remove the build, select a new one, and save.


iTunes Connect provides tools to help you track and manage the status of your app, including a history of status changes, an interactive Resolution Center page for resolving submission issues, and email notifications sent when app status changes occur.

Viewing Status History

The status history lists the state changes for a version of an app, the time the change occurred, and the originator of the change. Use this information to track your app through the review process.

To open the status history for an app version

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

  2. Select Activity

  3. Click App Store Versions from the platform you want to view.

Viewing Resolution Center Communications

If your app doesn’t pass review and is rejected, you receive a communication from Apple regarding the reason for the rejection. This information is available in iTunes Connect from My Apps or the App Details page:

  1. From My Apps, click the View Issues link under the app status.

  2. From App Details, click the link that indicates unresolved issues at the top of the page.


iTunes Connect displays information about an app rejection, including any specific App Review Guidelines that caused the app to be rejected. You can also view communications about your submission to Beta App Review on this page. The communications are listed in the left column, grouped by thread and with App Review communications appearing before Beta App Review communications. Select a communication to display the details on the right. You can ask questions or respond to the review information in the detail area.


You can correspond with Apple using this page until you resubmit the build for review. You can also send attachments, such as screenshots and supporting documents. If your app has been rejected because of a metadata issue, you can resolve the metadata issues and resubmit the same build for review.

Receiving App Status Notifications

An iTunes Connect user account can be configured so that the user receives email notifications when an app version changes status. See Viewing, Editing, and Deleting iTunes Connect Users. When configuring notifications, select App Status for the appropriate store territories or for worldwide.

Any users can configure their own notification status; they don’t need a user with an Admin role make the change for them.

Changing an App’s Status

Most status changes happen automatically in response to changes you make in iTunes Connect or changes made by Apple. However, in the following cases you set the app status directly:

When you’re ready to upload your app build. When you first create an iTunes Connect record for the app, the app status is Prepare For Submission. When you’ve entered all the required configuration and metadata and selected a build, clicking Submit for Review changes the status of the app version to Waiting for Review. See Submitting the App for App Review for more detail.

After you’ve submitted the build but before Apple has reviewed it. If you find an issue in your build that you want to fix while the status is Waiting for Review or In Review, you can remove your app from Apple’s review queue by removing the build from review. You can later resubmit the build with the same version information. If you wait until after Apple has reviewed the build before you remove it, you’ll need to create a new version in iTunes Connect to submit the updated build. See Removing a Build from Review.

Removing an app from being viewed on the App Store or Mac App Store. Whether for marketing reasons or because you find an issue with a version of an app that’s on the store, you can remove an app from the store. You can replace the app on the store without requiring the app to be reviewed again. See Removing an App from Sale.

Removing a Build from Review

Removing a build removes your app version from Apple’s review queue and changes its status to Developer Rejected. When you resubmit your app, the review process starts over from the beginning.

You can remove the build you’ve submitted if its status is any of the following:

To remove your build from review

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

  2. Select the platform version you want to remove. Above the app’s metadata, this message appears: “You can only edit all information while your version is waiting for review. To submit a new build, you must remove this version from review.” Click “remove this version from review.”


Removing an App from Sale

Removing an app from the store removes all versions of the app from sale. Users with previous versions of the app can’t update the app.

To remove your app from sale on the store

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

  2. Click Pricing and Availability.

  3. Select Remove from Sale from the Availability section.

  4. Click Save.

    The status changes to Developer Removed From Sale. Within 24 hours, your app won’t be seen on the store.

To sell an app you previously removed from sale, you must put it back on sale in the territories you want it to be sold in.

To put your app back on sale

  1. On your App Details page, click Pricing and Availability.

  2. Select the Available option from the Availability section.

  3. Click Save.

The app status changes from Developer Removed from Sale to Ready for Sale. Your app reappears in the store within 24 hours.

Your app will be be available in all territories that it was previously made available. If you would like to edit the territory availability, see the next section.

Changing the Territories Rights Information

While the version has the Ready for Sale status, you can change where an app version is available. You can prepare for the app to be available in additional territories by configuring additional language support before you make the app available in the territories that use those languages.

After you change an app’s territory rights, it may take up to 24 hours to refresh your app’s availability in stores in all territories.

To change the territories in which an app is available

  1. On your App Details page, click Pricing and Availability.

  2. Click Edit under Availability.

  3. Select the territories you want the app to sell in.

    Check the Select All box, or select individual territories where you want to sell your app. You can view territories by region by selecting the All Territories dropdown at the top right.

  4. Click Done.

  5. Click Save.

    The store in the new or changed territories updates within 24 hours.

Bitcode Auto-Recompilation

Occasionally, we may automatically recompile apps that include bitcode to improve hardware support or to optimize our software. If you do not want your app to utilize this auto-recompilation, you can opt out by checking the box under the section Bitcode Auto-Recompilation.


If you check this box, your app or a thinned version of your app may be unavailable for some devices. This may affect any app bundle the app is a part of, universal purchase, redownloads, or Family Sharing.

If you have selected to disable bitcode auto-recompilation and would like to maintain your app’s availability on the App Store, you will need to update the app with a new build that contains bitcode.

More information is available in the App Distribution Guide.

Scheduling Price Tier Changes

If you have a Paid Applications contract in effect, iTunes Connect allows you to schedule price tier changes for your apps over time. Scheduling is useful for sales and other temporary pricing changes that have a definite beginning and end date, as well as permanent pricing changes that have no end. For example, you might offer a promotional price for a month and then return to the regular price.

To schedule price tier changes, you must have already submitted the app, because the options for price scheduling appear only when you’re editing an already submitted app. For each price tier, you can set a start date (the date when the new tier takes effect on the store) and an end date (the date when the tier is no longer in effect and returns to the previously set price tier).

Feel free to set up as many price tier changes as you want. For each price tier change, your app changes prices on the effective date you provided and no interval can begin more than a year in the future. You’ll find your price tier schedule displayed on the Pricing and Availability section for your app.

A price tier schedule lists the Start Date and End Date for each Price Tier.


In the above example, the app was free at one time. Then at the beginning of the day on August 1, 2015, the price went up to tier 1. The price went up to tier 2 at the beginning of the day on October 1, 2015 and rose again to tier 3 at the beginning of the day on January 1, 2016. Unless further price tier changes are scheduled, the price remains at tier 3 indefinitely.

By default, the start date for pricing is the current date and the end date is No End Date (meaning the price remains the same indefinitely). To change the pricing, you add intervals.