What is App Store Connect?

App Store Connect is a suite of tools for managing apps sold on the App Store for iPhone, iPad, Mac, Apple Watch, Apple TV, and iMessage. As a member of the Apple Developer Program, you'll use App Store Connect to submit and manage apps, invite users to test with TestFlight, add tax and banking information, access sales reports, and more. You can read more about how to use each section in App Store Connect Help, or watch the App Store Connect Basics Video.

Note that iTunes Connect is used to manage content on the iTunes Store and iBooks Store.

What is App Store Connect for iOS?

Using App Store Connect for iOS, you can view sales data, app metadata, and customer reviews on your mobile device. You can also check app status, release new versions of your app, reject binary that has been submitted for review, and respond to active Resolution Center issues.

Trends reflects the same data available in Sales and Trends on the App Store Connect website.

App Store Connect for iOS is available on the App Store. If you create a new user on App Store Connect, the new user may need to wait up to 24 hours before they can access App Store Connect for iOS. Additionally, new users will not be able to sign in to App Store Connect for iOS unless they first sign in to App Store Connect and agree to the App Store Connect Terms of Service. For additional details, see App Store Connect for iOS in App Store Connect Help.

Where can I add my bank account information so I can receive payments?

Add information about the bank account where you'd like to receive payments in Agreements, Tax, and Banking. Learn more from the FAQ and the video tutorial that you'll find in Resources and Help.

How do I add or edit a bank account?

To receive payments from Apple, you need to enter electronic banking information in the banking section of Agreements, Tax, and Banking. See Enter banking information in App Store Connect Help for more information.

What banking information am I required to provide?

You will need to provide the following information:

  • Bank Country
  • Bank code
  • Bank Account Number
  • Account Holder Number
  • Account Holder Type
  • Bank Account Type
  • Bank Account Currency

For more information, see Enter banking information in App Store Connect Help.

Can I receive payments to multiple banks?

No, you may only have one bank selected to receive payments.

What do I do if I see a message on App Store Connect that I'm missing bank account information?

If you see a message requesting additional information, go to Agreements, Tax, and Banking and complete your bank account information.

Why am I getting a "Please enter a valid bank account number" error message?

Some bank account numbers have leading zeros. Be sure to include all leading zeroes when entering your banking information on App Store Connect.

Your bank account number and your IBAN are two separate numbers. Don't enter your IBAN into the bank account number field.

Why can't I view my bank account information?

Only App Store Connect users with the Admin or Finance role can see bank account information. If you have the correct user role in Users and Roles, make sure that there isn’t system maintenance taking place on App Store Connect. System maintenance typically lasts about 5 hours. If it still doesn’t work after that, let us know.

Which tax forms are required and how do I complete them?

U.S. tax forms are required for all developers. Other tax form requirements depend on where your entity is based.

All tax forms are available in Agreements, Tax, and Banking on App Store Connect. See Tax forms overview to understand which tax forms are required for you, and how to complete them. The following tax forms are available:

Which U.S. tax form am I required to complete?

The U.S. tax form you will need to complete will depend on several factors. You will be presented with a set of questions, which will direct you to the U.S. tax form that is appropriate for your situation.

Do I need to sign a Paid Applications Agreement?

To sell your apps for a price, the team agent must sign your Paid Applications agreement. The Paid Application Agreement is an optional agreement that is part of the Developer Program License agreement in your developer account. For additional information, see Agreements, Tax, and Banking overview in App Store Connect Help.

What user roles are available to App Store Connect users?

The following roles are available to App Store Connect users:

  • Legal
  • Admin
  • Finance
  • App Manager
  • Developer
  • Marketer
  • Sales
  • Customer Support
  • Reports

To learn about the access and privileges available for each role, see App Store Connect Help.

What is the Preferred Currency setting?

When you select your preferred currency, you'll see pricing listed in the Pricing and Availability section of My Apps in that currency.

How can I create a new user in App Store Connect?

Users with the Admin or App Manager role can create a new user in App Store Connect. To do so, click the + button in Users and Acceess and provide the first name, last name, and email address of the new user. For more information, see Add and edit users in App Store Connect Help.

How can I delete an App Store Connect user?

Users with the Admin role can delete other users. To do so, select the user in Users and Access, then click Delete User. For more information, see Add and edit users in App Store Connect Help. To remove the user with the Legal role, also known as the Team Agent, you must contact Developer Support first to reassign the Legal role to another user.

How can I create sandbox test users to test my in-app purchases in the sandbox test environment in App Store Connect?

Users with the Admin role can create sandbox test users in App Store Connect. To do so, click Sandbox Testers in Users and Access, then click the + button. For more information, see Add a sandbox tester in App Store Connect Help.

How can I delete a test user?

To delete a test user, click Test User in Users and Access, select the user account, and click Delete User. Note that the Apple ID of the deleted test user cannot be used again for any account. For more information, see Delete a sandbox tester in App Store Connect Help.

How do I view my expected payment and financial data?

Use the Payments and Financial Reports section of App Store Connect to view your payments owed, amounts paid to you, exchange rates applied, and more. See View payment information for more information.

You can also download monthly financial reports, which are made available once a month for the previous month's earnings by the end of the current fiscal month. Financial reports show final payments made to you based on closed transations and finalized proceeds using the Apple fiscal calendar. They only include paid transactions where we are able to collect payment from the customer (see Schedule 2 of your Developer Agreement). For details on each field, see Financial Report fields. You can opt-in to email alerts that notify you when financial reports are available for download in App Store Connect.

You must have the Admin or Finance role in App Store Connect in order to view this section. For additional information, see Getting paid overview in App Store Connect Help.

When will I be paid?

Payments are made within 45 days of the last day of the month in which app purchases were made. To receive payment, you must have provided all required banking and tax information and documentation, as well as meeting the minimum payment threshold.

If your bank and bank account currency is listed in the minimum payment threshold, you must exceed a minimum payment threshold of $10 USD. For the Korean Republic Won (KR/KRW), the minimum threshold is $50 USD due to requirements both locally and at the bank. All other bank countries and bank account currencies must exceed a minimum payment threshold of $150 USD.

How are payments made?

All payments are made by Electronic Funds Transfer. When available, payments are sent by low value ACH, as opposed to high value wire transfer. Apple's bank will consolidate payments for different financial reports when possible, generally resulting in a single payment for all earnings each month the requirements for being paid have been met. See Getting paid overview in App Store Connect Help for more information.

Can I split payments for my sales?

Apple accepts one bank account and makes one payment to that account during each monthly payment cycle if all requirements for payment have been met.

What is the exchange rate applied to my payments?

Our bank converts payment amounts into the currency of your bank account. The exchange rate is established by our bank and, due to Apple's volume, is generally a more favorable rate than used by your local bank. The rates are typically the spot rate on the date of payment and no more than three business days prior to the date the proceeds are received into your account.

How do I download my financial reports?

Click on Create Report on the top right corner in Payments and Financial Reports, then select All Regions or choose individual region. For more information, see Download financial reports in App Store Connect Help.

We also have a command line tool, Reporter, available for you to automate the downloading of your Sales and Trends reports and Payments and Financial reports. To learn more, see the Reporter User Guide.

How do I understand my financial reports?

Your financial reports are presented as groups of transactions, displayed in distinct rows. Each row represents a unique combination of an app, transaction type (product type identifier), price (proceeds and customer price), country of sale, sale or return, and more. Each of the columns reference different aspects of a group of transactions. For additional information, see Financial report fields in App Store Connect Help.

What does the withholding tax amount represent?

The withholding tax displayed represents amounts withheld by Apple and remitted to taxing authorities in accordance with government requirements specific to the territory.

Withholding tax is specific to particular territories where transactions occurred or where payments are being distributed by Apple. Withholding taxes can vary based on your location, the completion of any optional tax forms and the tax treaties entered into by your country. See Tax forms overview for more information.

What is the best way to open the financial report? I seem to be having technical issues.

Once you download your financial report, you'll beed to unzip the compressed gzip (.gz) file by opening it or using a utility. Then, open the extracted tab-delimited text (.txt) file in a spreadsheet application. For more information see Download financial reports in App Store Connect Help.

What does the Payment Returned amount represent?

When a payment made to you is returned, you will see the return at the top of the page highlighted in red as an amount added to the cumulative balance of what you are owed. Once you make any necessary banking updates to resolve the return reason, we will attempt to repay the returned amount along with all other amounts owed within two payment cycles of your banking update. See Resolve a returned payment error in App Store Connect Help for more information.

Why am I not receiving Financial Report Notifications?

If financial reports are available for your account and you have not been receiving the related email notifications, confirm that your email address is entered accurately in App Store Connect and that your user profile is set up to receive financial report notifications.

If these items are set up correctly, check your email client and/or spam filter to make sure the email address do-not-reply@apple.com is not being blocked.

What can I see in Sales and Trends?

Sales and Trends provides next-day sales and unit data so that you can measure the performance of your free or paid iOS, tvOS, and macOS apps, as well as any associated in-app purchases. You can quickly view units, proceeds, sales, and pre-orders, view sales activity for auto-renewable subscriptions, and access and add customized filters.

Data in Sales and Trends is recorded when a customer initiates a transaction on the App Store. For more information, see the Sales and Trends Guide.

Why do I see higher or lower sales for certain periods of time?

It's very common for sales to rise and fall over time, which will show up as periods of high volumes and low volumes in your downloads.

We can't comment on specific reasons why your download volumes might change over time or on other changes in customer behavior including redownloads, purchases, or refunds.

Why can’t I see sales for a particular item?

That item may not be available on the store. Make sure you've accepted the latest agreements in Agreements, Tax, and Banking. If you've accepted the latest agreement, check the Pricing and Availability section and the status for your item on App Store Connect.

Why do I see sales for in-app purchases in territories in which my app is not available?

While apps are only available for sale in the territories you specify, In-App Purchases are available in all territories. This allows customers to continue using apps they own, for example, after they move to a different country. Customers can only make In-App Purchases if they already own that app.

Will I still have access to Sales and Trends information after I transfer my app?

Yes, you will continue to have access to Sales and Trends information for sales of your app that occurred prior to the transfer. The recipient of the transferred app will only receive app sales information that occurred after the transfer. Learn more about transferring your app in App Store Connect Help.

Why am I seeing more updates than total downloaded units in Sales and Trends?

Your total downloaded units are based on unique users. Updates are counted on every device on which they are installed, even when the device shares the same Apple ID. If you release frequent updates of your app, you may see significantly more updates than total downloads.

Why don't my Sales and Trends reports match up with reports from Payments and Financial Reports?

Sales and Trends provides next-day sales and unit data so that you can measure the performance of your free or paid iOS, tvOS, and macOS apps, as well as any associated in-app purchases. Data in Sales and Trends is recorded when a customer initiates a transaction on the App Store.

Payments and Financial Reports provides information on final payments made to you based on closed transactions and finalized proceeds using the Apple fiscal calendar. Financial reports only include paid transactions where we are able to collect payment from the customer (see Schedule 2 of your Developer Agreement).

You may see differences between Sales and Trends reports and Payments and Financial Reports due to the following reasons:

  • Processing status. Transactions may take time to process and close. Transactions initiated in a particular month and shown in Sales and Trends may not be reflected in Payments and Financial Reports until the payment is processed and the customer gets the receipt, which may be in the following fiscal month. Further, transactions where we are never able to collect payment will not be shown in financial reports.
  • Exchange rate. Sales and Trends estimates the USD amount of sales and proceeds based on a rolling average of the previous month's exchange rates. Final payments in Payments and Financial Reports are based on the exchange rate used to convert each report currency to the currency of your bank account. For more information about this exchange rate, see Getting Paid in the Payments and Financial Reports Guide.

Why do some transactions show zero proceeds, even though my app isn't free?

Your reports include downloads of app updates. Updates are always free and these transactions will show Product Type Identifier 7. App sales will show Product Type Identifier 1 and can either be free (no proceeds) or paid. If your app isn't intended to be free but you see zero-proceeds transactions with Product Type Identifier 1, update the price of the app in My Apps.

Why am I seeing refunds for an amount that is less than the customer price?

Customers that paid for subscriptions may get a pro-rated or partial refund to factor in the content they’ve already received.

How do I manage chart annotations in my Sales and Trends dashboard?

To turn chart annotations on or off:

  1. From the App Store Connect homepage, click Sales and Trends.
  2. On the left side, click Units, Proceeds, Sales, or Pre-Orders.
  3. On the right side of the chart, click Area.
  4. From the pop-up menu under Chart Annotations, select or de-select the events you would like to be displayed.

How can I determine which prices my subscribers are paying?

The Subscription report includes the number of active subscriptions and corresponding customer prices. Learn more about subscription reports in the Sales and Trends Guide.

What is Introductory Price Conversion Rate and Average Introductory Price Conversion Rate?

The Introductory Price Conversion rate is the number of subscriptions with introductory prices that converted to paid subscriptions divided by the number of subscriptions with introductory prices about to end during a specific month. A subscription with an introductory price converts at the end of its introductory price period, unless a subscriber cancels.

For example, if 10 subscribers signed up for a 1 Month Pay Up Front Introductory Price between January 1 and January 25 and 8 of them converted at the end of their Introductory Price period, then their Pay Up Front conversion rate would be 80%. The Average Pay Up Front conversion rate is simply the averge across the months shown.

Upgrades, downgrades, or crossgrades during an introductory price period are included in conversion rate. Opt-In from Introductory Price is also included.

What is Retention Rate and Average Retention Rate?

The Retention Rate is the number of subscription renewal events divided by the number of eligible subscription renewals during a specific month. An auto-renewable subscription renews at the end of its subscription period, unless the subscription is canceled.

For example, if ten 7-day subscriptions were eligible to renew on January 7, 14, 21, and 28 and all ten subscriptions were renewed on January 7, 14, and 21 (but none on January 28), then the renewal rate for January would be 75% (or 30 renewal events divided by 40 eligible renewals). If only 3 subscriptions renewed on January 28, then the renewal rate would be 82.5% (or 33 renewal events divided by 40 eligible renewals). The Average Retention Rate is simply the average across the months shown.

Note that retention rate is based on when a subscription renews and not when it started. In the previous example, each of the 10 subscribers could have started on different dates prior to January, but all were up for renewal at some point that month. Upgrades, downgrades, and crossgrades are included in retention rate. Free trial conversions are not included.

Why is the retention rate on the subscription summary page different from the retention rate on the subscriptions retention page?

The retention rate shown on the subscription summary page shows the retention rate of the most recently completed calendar month. The subscription retention page shows the retention rate of the past 30 days from the current date.

What is App Analytics?

App Analytics lets you measure user engagement, marketing campaigns, and monetization for your iOS and tvOS apps. You can:

  • View key metrics, such as Impressions, Sales, and Installations.
  • Discover how users are finding your app.
  • Track and measure the performance of your marketing campaigns.
  • View user retention for your app over time.
  • Filter metrics by purchase date, territory, source type, and more.

To start using App Analytics, you must have the Admin, Finance, or Sales role in App Store Connect. You can access App Analytics by signing in to your App Store Connect account. For more information, see the Analytics and reporting overview in App Store Connect Help.

Why can't I see my app in App Analytics?

An app needs to have at least one approved version to display in App Analytics. Deleted apps won't display in the apps list.

Why do I see different data in Search Ads Reports than in App Analytics?

App Analytics and Search Ads Reports are used for different purposes and therefore capture metrics differently. While you may see metrics with the same labels (such as Impressions) in App Analytics and in Search Ads Reports, these metrics and attribution windows are not defined in the same way, resulting in different data. Comparing data from these two tools is not recommended.

App Analytics lets you measure user engagement and monetization of your iOS and tvOS apps, as well as track the impact of marketing campaigns based on custom campaign links. Search Ads Reports helps you understand the performance of your Search Ads campaigns on the App Store for iPhone and iPad. For more details on App Analytics, see the analytics and reporting overview in App Store Connect Help. For details on Search Ads Reports, see Understanding reports.

Why are App Store product page views are lower than App Units?

You may see more App Units than product page views if customers downloaded your app without visiting your app’s product page on the App Store. For example, if a customer searches for your app in the App Store and downloads it directly from the search results, we count an App Unit and Impression, but not a product page view. For more details on App Analytics, see the the analytics and reporting overview in App Store Connect Help.

Why do I sometimes see an error that there isn’t enough data?

To protect customer privacy, we only show data in App Analytics after a certain number of data points are available.

Why am I seeing more crashes than sessions?

We don't record sessions unless they are longer than 2 seconds. So, it's possible that the app crashes right when users open it, which is a crash without a session.

Where does campaign and website data for Apple TV come from if web searches are not available on Apple TV?

Metrics for Apple TV are tracked by the user's Apple ID, which means that data for web searches on any Apple device, including iPhone or iPad, will be displayed in App Analytics. If a user comes across a campaign or website on their phone that led them to your app, and they also downloaded that app on Apple TV, that purchase will be tied to that campaign or website. For more information, see Measuring campaign performance in App Store Connect Help.

How do I view sales for individual in-app purchases?

You can view sales for individual in-app purchases by filtering by purchasable item. Data for the purchasable item dimension is available starting December 4th, 2017. For more information, see View app analytics in App Store Connect Help.

What is an app bundle?

App bundles make it easy for you to group up to 10 of your iOS or macOS apps together in a single download. Apps in a bundle must be either all paid or all free. A paid app bundle can only include paid apps and must be offered at a reduced price. Each app in a free app bundle must be free and offer an auto-renewable subscription that allows the user to subscribe to and access content or services in all apps of the bundle. 

To learn how to create and submit app bundles to the App Store, see App Store Connect Help.

How many app bundles can I create?

You can create as many app bundles as you want, but you can only have up to 10 app bundles available on the App Store at any given time.

How many bundles can an app belong to?

An app can be in up to three app bundles available on the App Store at any given time.

Can I include apps from another developer in an app bundle?

No, you can only include apps associated with your own developer account.

Why is my app bundle not available on the App Store?

After you have submitted an app bundle for App Review and it has been approved, it will automatically become available for sale when all of the apps it contains are available and all other requirements are met.

In order to be available, app bundles must meet the following requirements:

  • Apps in the bundle must be either all paid or all free. A paid app bundle can only include paid apps and must be offered at a reduced price. Each app in a free app bundle must be free and offer at least one auto-renewable subscription.
  • Paid app bundles must be sold at a reduced price, which is a price tier less than the sum total of the individual app prices in the bundle.
  • A paid app bundle’s price must not be lower than the highest app price in the bundle. If an app in the bundle goes to a price that is higher than the price of the bundle, the bundle will automatically be removed from the store.
  • There are no bundle-specific territory settings. An app bundle will be live only where all member apps have common territories.
  • Only ten bundles can be marked as cleared for sale at any time per developer account. If you have ten bundles marked cleared for sale, you can create additional bundles, but you can’t check Cleared for Sale for an additional bundle unless you first uncheck it from another bundle.
  • A single app can be in no more than three cleared-for-sale bundles at one time.

How do I edit the app bundle information?

You can change the name, description, and marketing URL of an app bundle on App Store Connect. These changes must be approved by App Review. Learn more about how to edit app bundle information in App Store Connect Help.
Most other types of app bundle information, including screenshots, localizations, and so on, are automatically pulled from the information of individual apps in the bundle and cannot be edited.

Can I delete an app bundle?

No, app bundles can't be deleted.

Can I add or remove apps from an app bundle?

You can only add or remove apps from an app bundle before it has been approved by App Review. If your app bundle has already been approved, you must create a new app bundle.

Can I transfer an app that is in an app bundle?

Yes, you can transfer apps that are included in an app bundle. When you transfer an app included in an app bundle currently available on the App Store, the app bundle will be removed from the App Store.

You can then create a new app bundle that doesn’t include the transferred app.

I updated my app information. Why isn't it displaying in some App Store territories?

When you update your app's metadata, it can take up to 24 hours to appear on the App Store.

How will the company name field display on the App Store?

If you enrolled in the Apple Developer Program as an organization, you may also set a customer-facing seller name, or “company name” different from your legal entity name if that seller name is a registered trade name or DBA. For example, if your legal entity name is “Apps Company LLC” or Apps Corporation” your trade name may simply be “Apps”. This displays as “seller” on the App Store and is used for navigation and to group your apps. You can set this in the company name field only when adding an app to your account the first time.

If you're enrolled as an individual, this option is not available to you and the seller name is the same as your legal name.

How can I view and respond to customer reviews on the App Store?

You can view all customer ratings and reviews from the App Store directly in App Store Connect. For iOS, macOS, and watchOS apps, you can also respond to customer reviews. For more information, see Ratings and reviews overview in App Store Connect Help.

What is the trade representative contact information for the App Store in South Korea?

If your Apple Developer Program is enrolled as a organization (not an individual), and you distribute your apps for download in South Korea, you can provide trade representative contact information to display on the Korean App Store in compliance with Korean e-commerce regulations. The trade representative is someone within the company who has the authority to represent the company, such as the CEO, Representative Director, or other responsible officer within the company. If you are based in the South Korea, the contact information includes your e-commerce and business registration numbers. See App Store Connect Help for more information.

How is my app searchable on the App Store?

Your app is searchable by app name, app subtitle, keywords, and your company name. Your app name, app subtitle, and keywords are set by you during your app metadata setup and can be edited when you submit an app update or when your app has an editable app status. Learn more about discovery on the App Store.

How can I add or edit keywords for my app information?

You can edit your keywords as long as your app has an editable app status. To edit keywords, find your app in My Apps and go to the Keywords field for each platform version. If you have localizations, you need to update keywords for each localization that you've added. Words in the Keywords field must be comma-separated and you can only enter up to 100 characters. Keyword terms must be related to your app content and can't contain offensive terms. Don't include other app names as keywords.

How are app bundles displayed in App Store charts?

App bundles are included in the same charts as individual apps, with each app bundle purchase counting as a single sale, regardless of how many apps are included in that bundle.

Why isn't my localized app information displaying in a specific language on the App Store?

If you would like to see a specific localization for your app on the App Store, you may need to change your language on your device. Learn more.

What currency is used for a given App Store Territory?

You can refer to Exhibit C of your Paid Developer Agreement to see the currency used by a specific App Store territory.

What is an in-app purchase?

An in-app purchase is an offering that your customers can purchase from within your free or paid app. To offer an in-app purchase, the binary for your app must support the in-app purchase option. Learn more.

What do the different in-app purchase statuses mean?

The in-app purchase status indicates whether your in-app purchase is available or if it needs your attention. In-app purchase products have statuses such as "Ready to Submit" or "Approved" or a status indicator. The status tells you immediately whether your product needs attention. For a full list, see In-app purchase statuses.

What are the metadata requirements for my in-app purchase?

The full list of metadata and assets that you will need to provide for your in-app purchase can be found under In-app purchase information in App Store Connect Help.

Which in-app purchase information can be edited?

You can edit the reference name, price tier, Cleared for Sale status, language display, languages, and screenshots for an in-app purchase. Product ID and in-app purchase type cannot be edited once your in-app purchase has been created. For details, see In-app purchase information.

Can I delete an in-app purchase?

You can delete an in-app purchase on App Store Connect as long as its status is not In Review.

Before you delete the in-app purchase, you must make sure that your app does not contain any code related to that specific in-app purchase. If you no longer wish to offer an in-app purchase, you will need to remove the in-app purchase from sale by deselecting the Cleared for Sale checkbox. If you delete an in-app purchase, you may receive customer complaints as the in-app purchase coded into older versions of your app may not work as intended.

Deleted in-app purchases will not be searchable on App Store Connect, cannot be restored, and the product ID cannot be reused for any other in-app purchase.

How do I add my in-app purchases to promote on my App Store product page?

You can promote up to 20 in-app purchases, including subscriptions, on your app's product page on the App Store for iOS 11.

To get started, upload promotional images for the in-app purchases you’d like to promote, as described in Add a promotional image and submit for review.

Next, you can use the App Store Promotions tool in App Store Connect to manage their order and visibility on the App Store. Learn more.

Transactions for promoted in-app purchases rely on a delegate method in SKPaymentTransactionObserver that handles purchases on the App Store. Your app will need to support the delegate method for your promoted in-app purchases to display on your product page.

Can I promote in-app purchases for specific territories?

No, in-app purchases can’t be promoted for specific territories. They will display on your App Store product page on devices running iOS 11 or later in all App Store territories where your app is available.

Where can I find information about setting up auto-renewable subscriptions in App Store Connect?

Learn about setting up auto-renewable subscriptions in the Workflow for configuring in-app purchases section of App Store Connect Help. Find information on creating subscription groups, managing pricing for new and existing subscribers, and more.

Am I required to have levels in my subscription group?

No, you are not required to differentiate your subscriptions into levels. You can offer a single subscription in-app purchase without using levels or you can offer multiple subscriptions and assign them all to the same level within a group.

Can I create free subscriptions?

No, you won't be able to create new free subscriptions, but if you previously created free subscriptions, they will remain active. You may still offer free trials for paid subscriptions.

What happens to my current subscribers if I change the price of my auto-renewable subscription?

If you decrease the price of your auto-renewable subscription, existing subscriptions will automatically renew at the lower price.

If you choose to raise the price of your auto-renewable subscription you can either raise the price for all customers or preserve pricing for existing customers. If you increase the price of your subscription while keeping existing subscribers at their current price, subscribers will be charged their usual price at renewal.

Following the launch of iOS 10, if you increase the price of a subscription without preserving the current price, Apple will notify existing subscribers of the following:

  • Their current subscription price
  • The new higher price
  • The date they will be charged the new price

Subscribers will have the option to agree to the higher price, or view other subscription options in the group. If they do not agree to the higher price before their next renewal date, their subscription will not automatically renew.

When will I earn 85% of my auto-renewable subscription’s price?

After a subscriber completes one year of paid service of your auto-renewable subscription, you automatically receive 85% of the subscription price, minus applicable taxes, on the subscriber’s subsequent renewals. Service level changes within a subscription group do not interrupt days of paid service.

The ability to earn 85% takes effect in June 2016 for subscription renewals occurring after that date. iOS, macOS, tvOS and watchOS apps are eligible.

How is a subscriber's days of paid service defined?

A subscriber's days of paid service is defined as the number of days the subscriber has an active paid subscription, excluding free trials, marketing opt-in bonus periods and grace periods. Service level changes within a subscription group do not interrupt days of paid service.

If a subscriber cancels their subscription, a 60-day grace period begins. If the customer resubscribes to any product within the same subscription group during the grace period, days of paid service resumes from the most recent cancellation date.

For example, if the customer has accumulated 90 days of paid service, then cancels, then resubscribes 45 days later, their days of paid service resumes at 91 days. If the customer resubscribes more than 60 days later, their days of paid service resets to zero upon renewal. You then receive 70% of the subscription price, minus applicable taxes, on subsequent renewals until the subscriber accumulates a year of paid service.

The grace period applies to each of a subscriber's cancellations. If a customer cancels and resubscribes to a subscription multiple times, a new 60-day grace period will be associated with each cancellation.

How will changes to foreign exchange rates and tax adjustments affect auto-renewable subscription pricing?

Apple will not make price adjustments on your auto-renewable subscription products. Retail price changes initiated by Apple due to tax changes and significant foreign exchange rate movements will exclude auto-renewable subscriptions. For any value-added tax (VAT) rate changes, your proceeds and Apple’s commission will be calculated after the deduction of VAT, which means that your proceeds will change. You can choose to pass any changes caused by taxation or foreign exchange onto your subscribers by adjusting the price for your subscription. Keep in mind that all price increases require customer consent.

How do I discontinue my auto-renewable subscription?

Your customers expect your content to be available throughout their subscription and you’re also required by your agreement to provide that content. If you have to discontinue an auto-renewable subscription to prevent new users from subscribing, see Remove an auto-renewable subscription from sale.

If you remove an auto-renewable subscription from sale, your customers will be notified about the discontinued subscription. Even if you have to discontinue a subscription, you are contractually obligated to fulfill the content delivery to your customers for the entire duration of their subscription period.

If your app does not function without the discontinued auto-renewable subscription, remove your app from the App Store.

Also, let us know about your decision to discontinue your subscription.

What is introductory pricing and who is eligible to offer it?

Introductory pricing allows you to provide new customers with a discounted introductory price or free trial for a limited time. iOS, tvOS, and macOS apps that offer auto-renewable subscriptions are eligible to offer introductory pricing. 

How do I set up an introductory price?

Introductory pricing can be set up and managed for each subscription on your in-app purchase in App Store Connect. You can have one current and one future introductory price per territory.

If I raise my standard subscription price and choose not to preserve pricing, what happens to customers that are in an introductory price period?

If you choose not to preserve pricing when raising the standard subscription price, then the customer will convert from an introductory price to a standard price at the original subscription price that was displayed when they bought your subscription. The customer will need to consent on the next billing cycle in order to auto-renew at the higher price.

How do I create an iMessage app or sticker pack in App Store Connect?

From My Apps, click on the plus sign and choose New App. Then, select iOS app and complete the required metadata. You can find more detailed instructions in the Add a new app section of App Store Connect Help.

You can also watch this video on how to create and submit sticker packs in App Store Connect.

If you are unfamiliar with the Messages framework, but want to learn how to get started, you can read about it here.

Can I update my iOS app with an iMessage extension to be a standalone iMessage app on App Store Connect or vice versa?

No, this is not possible once the app is live on the App Store. For more information, see Change iMessage app type.

Can I update my standalone sticker pack into a standalone iMessage app?

Yes, you may submit a sticker pack to the App Store for iMessage, and later submit an iMessage app as an update to the existing app. Before doing this, be sure to understand the App Review Guidelines. You can find information about Creating a new version in App Store Connect Help.

How do I add or update my screenshots?

If your app is the same across multiple device sizes and localizations, simply provide the highest resolution screenshots required. For iPhone, screenshots for 5.5-inch devices (iPhone 6s Plus, iPhone 7 Plus, iPhone 8 Plus) are required. For iPad, screenshots for 12.9-inch iPad Pro (2nd generation) are required.

Screenshots for iPhone XS Max are optional. These screenshots will scale down for iPhone XR, iPhone XS, and iPhone X, and will display with rounded corners.

Screenshots for 12.9-inch iPad Pro (3rd generation) are optional. These screenshots will scale down for 11-inch iPad Pro, but not for older iPad devices, and will display with rounded corners.

App previews will scale down in the same way.

For details on how to upload screenshots, see Upload app previews and screenshots in App Store Connect Help.

How do I add custom screenshots for a specific device type?

Go to your app’s version page on App Store Connect, and click on Media Manager. If you’ve previously added 5.5-Inch Display screenshots, uncheck “Use 5.5-Inch Display,” and drag in your customized screenshots for the appropriate device size. For additional details, see Add screenshots and previews for other device sizes and localizations in App Store Connect Help.

How do I add custom screenshots for my localization?

If you’ve already added your 5.5-Inch Display screenshots, you can toggle between localizations at the top right of your app’s version page. Choose the localization you’d like to update, uncheck 5.5-Inch Display screenshots used for your primary localization, and drag in your own custom screenshots for that locale. You can also do this from the Media Manager page. For additional details, see Add screenshots and previews for other device sizes and localizations in App Store Connect Help.

What is an app preview?

App previews are optional short videos that showcase what’s great about your app to help customers make an informed decision about downloading your app. Customers can watch app previews, which generally feature device-captured footage of your app, directly from your product page in the App Store. Each app can have three app previews for each supported device size and App Store language. To learn more, such as how to create an app preview, see Show More with App Previews. For technical specifications, see App Preview Specifications.

Can I use iPhone X and later assets for iPhone 8 Plus and earlier device wells?

No, 6.5-inch display screenshots don’t cascade down to earlier device sizes due to differences in the aspect ratio and the variation in layout for apps optimized on iPhone X and later devices. For additional information, see Upload app previews and screenshots or Screenshot specifications.

What do the different app statuses mean?

The app status indicates immediately whether your app needs attention.

  • A red status indicator means that you need to perform some action before an app can be available on the App Store.
  • A yellow status indicator means that some process is ongoing, controlled either by you or by Apple.
  • A green status indicator means that the app is Ready for Sale.

For a full list, including definitions, see App statuses.

What is phased release for automatic updates?

You can release an update to your iOS app in stages by enabling Phased Release for Automatic Updates in App Store Connect. With phased release, your version update will go out to an increasing percentage of users with automatic updates turned on, over a 7-day period. The percentage of users completing the automatic update each day during the phased release period will be displayed in App Store Connect. All users will still be able to manually update your app directly from the App Store and new customers will always see your most recent Ready for Sale version. If you find an issue with your version update, you can pause the phased release at any time, for a total of up to 30 days, regardless of the number of pauses. Learn more.

Do I have to submit all platform binaries for review at the same time?

No. Binaries for each platform can be submitted separately and the status of one platform’s binary does not affect the other.

How do I make my app a universal purchase app?

In My Apps, select the app you want to make into a universal purchase app. Then, click Add Version or Platform to attach a tvOS version to your existing iOS app. You can also start with a tvOS app first and add the iOS version later. The order in which you add the platforms is up to you.

How do I make my app available for pre-order?

Before releasing your app on the App Store for the first time, you can choose to offer it as a pre-order. Customers can see your product page and order your app before it's released for download. Once your app is released, customers will be notified and your app will automatically download to their device. For paid apps, customers will be charged before download. See Publish your app as a pre-order in App Store Connect Help for more information.

Can I delete an app from App Store Connect?

Users with the Legal role (Team Agent) can delete an app from App Store Connect. See Delete an app in App Store Connect Help for more information.

How do I offer promo codes?

Promo codes allow you to offer a free copy of your app or in-app purchase for promotional purposes and are valid for 28 days from the day they are generated or until your agreement expires, whichever comes first. You can request up to 100 total promo codes for each platform version or 100 promo codes for each in-app purchase item, with a limit of 1,000 total in-app purchase codes per app every six months (resetting on January 1 and July 1). For more information, see Promo codes overview in App Store Connect Help. 

Can I deliver my app information using XML?

Yes, Apple offers a command-line tool, Transporter, for submitting metadata, in-app purchases, or screenshots and app previews to the App Store. You can also request Catalog Reports. If you already have Xcode or Application Loader installed, Transporter is already included in these apps. See the App Metadata Specification and the Transporter User Guide for more information.

How do I offer a custom app for business?

You can distribute your app privately to authorized Volume Purchase Program for Business members that you add in App Store Connect. This option is only available if you’ve created the app for the first time and haven’t been approved yet. For details, see Distribute your app privately to business in App Store Connect Help.

For business guidance, see Develop Custom Apps for Business.

How do I enable my app for Game Center?

To participate in Game Center, you must agree to the most recent Developer Program License Agreement.

Your app must also include the Game Kit capability within the UIRequiredDeviceCapabilities array in the binary. For more information about using Game Kit to include this capability, see the Game Kit Programming Guide in the iOS Developer Library.

To enable Game Center, go to My Apps, find your app, and then go to your app's Game Center section to enable it. The latest version of your app must have Game Center enabled when you submit your app version and the Game Center metadata for review. See the Game Center Configuration Guide for App Store Connect for more information.

What Game Center metadata can be edited?

Game Center metadata cannot be edited while the status of your leaderboard, achievement, or Game Center-enabled binary is In Review.

The following items cannot be edited after you submit the binary:

  • Leaderboard ID
  • Achievement ID
  • Leaderboard Sort Order

The following items can only be edited prior to the binary being Approved, or if the status is Developer Rejected or Rejected:

  • Leaderboard Score Format Type
  • Achievement Points

The following items can be edited when the the status of your first Game Center-enabled binary is Approved:

  • Leaderboard Score Format
  • Leaderboard Score Format Suffix
  • Leaderboard Score Range
  • Leaderboard Reference Name
  • Default Leaderboard Setting
  • Achievement Reference Name
  • Achievement Hidden
  • Achievement Image
  • Achievement Title
  • Achievement Pre-Earned Description
  • Achievement Earned Description
  • Achievement Version Compatibility

For more information about editing Game Center features, see Appendix A in the Game Center Configuration Guide for App Store Connect.

Why doesn't the single leaderboard ranking match the ranking in the combined leaderboard?

If you make a single leaderboard part of a combined leaderboard, the existing score data will remain on the single leaderboard, but it will not be carried over to the combined leaderboard. Only new scores will be available on the combined leaderboard.

If you remove a single leaderboard from a combined leaderboard, no scores on the combined leaderboard will be removed. However, new scores from the single leaderboard will not be posted to the combined leaderboard.

What are export regulations and how do I comply with them?

Apps uploaded to App Store Connect are uploaded to an Apple server in the United States. When you submit your app with the intention of distributing your app on the App Store or to external testers through TestFlight outside of the U.S. or Canada, it is considered a U.S. export and is subject to U.S. export laws (regardless of where your legal entity is based). If your app uses, accesses, contains, implements, or incorporates encryption, this is considered an export of encryption software, and is therefore subject to U.S. export and other country import compliance requirements.

See Export compliance documentation for encryption in App Store Connect Help to understand which documentation might be required for your app. See Provide export compliance documentation to learn how to submit the needed information in App Store Connect.

What is TestFlight?

TestFlight Beta Testing allows you to distribute your beta builds to up to 25 trusted internal users or up to 10,000 external testers per app before you make it available on the App Store. Testers use the TestFlight app to install beta builds on their iOS devices, allowing you to collect feedback on the features and functionality of your app. For an overview of the feature, see TestFlight Beta Testing.

What is the difference between a tester who is an App Store Connect user and an external tester?

App Store Connect Users must have the Admin, Technical, App Manager, Developer, or Marketer user role to beta test an app internally. After you upload a build with Xcode or Application Loader, all internal testers that you add will be able to access active (testable) builds.

External testers can be anyone you've added to a group or who has access to a public invitation link. Before your external testers can begin testing, your uploaded beta builds must be approved by Beta App Review.

How can I add and invite testers?

You can add testers once you’ve uploaded at least one build to App Store Connect.

To add up to 25 internal testers (your App Store Connect users) to test your app using TestFlight, see Add internal testers in App Store Connect Help.

To invite up to 10,000 external testers (persons outside your organization), see Invite external testers in App Store Connect Help.

How do I know if a tester is testing my app?

TestFlight in App Store Connect displays the Sessions and Crashes for each tester. For additional details, see View tester information.

Do I need to get approval to start testing beta builds?

To make your beta builds available to App Store Connect users, your app doesn’t need review by Beta App Review.

To make your beta builds available to external testers, your app may require approval by Beta App Review.

How do I appeal if my beta build was rejected?

To appeal your beta build being rejected, contact Beta App Review.

Why can't I remove my app?

Only App Store Connect users with a Legal or Admin role now have the ability to remove and restore apps. Apps can’t be removed if they are part of a Game Center group, in an app bundle, or currently available on the App Store.  An app cannot be removed if its actively being transferred to another provider. 

Additionally your app must be in one of the following states:

  • Prepare for submission
  • Invalid binary
  • Developer rejected
  • Rejected
  • Metadata rejected
  • Developer removed from sale
  • Removed from sale

Why can't I restore my app?

An approved app may not be restored if the name of the app is no longer available. If you believe an app is preventing you from using your trademark as an app name on the App Store, you can submit a claim to the App Store Legal Team.