App Store Connect: Complete Guide for Developers

App Store Connect is Apple's web-based portal for managing every aspect of your iOS, iPadOS, macOS, watchOS, and tvOS apps. It's where you submit apps for review, manage metadata and pricing, view analytics, configure in-app purchases, respond to reviews, and access your sales and financial reports.

If you develop for Apple platforms, App Store Connect is your operational headquarters. Understanding its features — and using them effectively — directly impacts your app's visibility, revenue, and user satisfaction.

This guide covers every major section of App Store Connect, with practical advice on how to use each feature to optimize your app's performance.

Getting Started with App Store Connect

Prerequisites

To access App Store Connect, you need:

1. Apple Developer Program membership ($99/year for individuals, $299/year for organizations)
2. An Apple ID associated with your developer account
3. Two-factor authentication enabled on your Apple ID

Account Roles

App Store Connect supports multiple team members with different permission levels:

Best practice: Use the principle of least privilege. Give team members only the access they need.

App Management

Creating a New App

To create a new app in App Store Connect:

1. Go to My Apps → click the + button → New App
2. Select platforms (iOS, macOS, etc.)
3. Enter your app name (this is what appears on the App Store)
4. Choose your primary language
5. Select a Bundle ID (must match your Xcode project)
6. Enter a unique SKU (internal identifier, not visible to users)
7. Choose Full Access or specific user access

Important: Your app name must be unique across the entire App Store. If it's taken, you'll need to choose a different name.

App Information

The App Information section contains metadata that applies to all versions of your app:

• Name — Your app's display name on the store (30 characters max)
• Subtitle — Secondary text under your name (30 characters max) — critical for ASO
• Category — Primary and secondary category selection
• Content Rights — Declare if your app contains third-party content
• Age Rating — Based on your responses to Apple's content questionnaire

Version-Specific Metadata

Each app version has its own set of metadata:

• Screenshots — Required for each device size you support
• App Preview Videos — Optional but highly recommended (up to 3 per locale)
• Promotional Text — 170 characters, can be updated without submitting a new version
• Description — Full app description (4,000 characters max)
• Keywords — 100 characters for search optimization (comma-separated)
• What's New — Release notes for the update
• Support URL — Required link to your support page
• Marketing URL — Optional link to your marketing page

The Keyword Field

The keyword field is one of the most valuable fields for App Store Optimization. You have exactly 100 characters to include search terms that the algorithm will index.

Keyword field best practices:

• Use commas to separate keywords (no spaces after commas)
• Don't repeat words already in your title or subtitle
• Don't include your app name or company name
• Don't use plurals if the singular is already included
• Don't use "app" or category names
• Use all 100 characters — every unused character is wasted opportunity
• Research keywords with volume and difficulty data before choosing

Example (budget tracking app):

expense,tracker,money,manager,budget,planner,spending,finance,savings,bills,receipt,scanner,monthly

TestFlight

TestFlight is Apple's built-in beta testing platform. It lets you distribute pre-release builds to internal and external testers.

Internal Testing

• Up to 100 testers (must be App Store Connect users)
• Builds available immediately after upload
• No App Review required
• Testers get automatic update notifications

External Testing

• Up to 10,000 testers per app
• Testers can be invited via email or public link
• First build in a group requires Beta App Review (usually 24-48 hours)
• Subsequent builds to the same group are auto-approved if no major changes
• Builds expire after 90 days

TestFlight Best Practices

• Use test groups to segment testers (e.g., "Internal QA", "Power Users", "New Testers")
• Write meaningful test notes describing what to test
• Monitor crash reports and feedback in the TestFlight section
• Use automatic distribution for internal testers, manual for external

App Analytics

App Store Connect provides built-in analytics that show how users discover and interact with your app listing.

Key Metrics

Using Analytics for ASO

The most valuable analytics for ASO are:

• Impressions → Product Page Views conversion — Tells you if your icon and title are compelling enough to tap
• Product Page Views → Install conversion — Tells you if your screenshots and description are convincing
• Source type breakdown — Shows where discoveries come from (search, browse, referral, web)
• Search terms (if using Apple Search Ads) — Shows which keywords drive installs

Analytics Limitations

Apple's analytics have known limitations:

• Data is delayed by 24-48 hours
• Not all metrics are available for all time periods
• Some data is only available for users who have opted into sharing
• Cohort analysis is limited compared to third-party tools

In-App Purchases and Subscriptions

Types of In-App Purchases

Subscription Configuration

For auto-renewable subscriptions:

1. Create a Subscription Group (users can only have one active subscription per group)
2. Add subscription tiers within the group (e.g., Basic, Pro, Enterprise)
3. Set pricing for each tier across all territories
4. Configure introductory offers (free trial, pay-as-you-go, pay up front)
5. Set up promotional offers for win-back campaigns
6. Configure offer codes for marketing campaigns

Subscription Pricing Strategy

• Apple takes 30% commission in year 1, 15% after year 1 (Small Business Program: 15% from day 1 if revenue < $1M)
• Price your subscriptions to account for the commission
• Use introductory offers to reduce barrier to entry
• Consider annual plans at a discount to improve retention
• Test different price points across different markets

App Review

Preparing for Review

Every new version (and first submission) goes through Apple's App Review process. Average review time is 24-48 hours, but can take up to a week during busy periods.

Common rejection reasons and how to avoid them:

• Crashes or bugs — Test thoroughly on physical devices
• Broken links — Verify all URLs in your app and metadata
• Incomplete information — Fill in all required fields in App Store Connect
• Login required — Provide a demo account in the App Review Notes
• Guideline violations — Read the App Store Review Guidelines thoroughly

App Review Notes

Use the review notes field to:

• Provide demo account credentials
• Explain how to access features that require specific conditions
• Note any known issues you're aware of
• Explain any unusual functionality

Expedited Review

If you have a critical bug fix, you can request an expedited review. Use this sparingly — Apple tracks how often you request it.

Sales and Financial Reports

Sales Reports

Available data includes:

• App Units (downloads) by date, territory, and source
• In-App Purchase revenue by product
• Subscription status (active, churned, reactivated)
• Proceeds (your share after Apple's commission)

Financial Reports

Monthly financial reports show:

• Earnings by territory and currency
• Apple's commission breakdown
• Tax withholdings
• Payment schedule and amounts

Payments

Apple pays developers on a monthly cycle:

• Fiscal month closes on the last Saturday of each month
• Payment issued approximately 33 days after the fiscal month ends
• Minimum threshold: varies by territory (typically $10 USD equivalent)

In-App Events

In-App Events are time-limited cards that appear on your product page, in search results, and in editorial collections.

Event Types

• Challenge — Competitive activity
• Competition — Organized competition
• Live Event — Real-time event
• Major Update — Significant new features
• New Season — New content period
• Premiere — First-time content availability
• Special Event — Unique occurrence

Why In-App Events Matter for ASO

In-app events are indexed for search, meaning they create additional keyword visibility beyond your standard metadata. They also:

• Create fresh content on your product page
• Appear in editorial curations
• Drive re-engagement from lapsed users
• Provide a reason to update your listing regularly

Best Practices

• Create events regularly (at least monthly)
• Use event names and descriptions that include target keywords
• Time events around holidays, seasons, and trends in your category
• Promote events through your other marketing channels

Custom Product Pages

Apple allows you to create up to 35 custom product pages, each with unique screenshots, promotional text, and app previews. These are ideal for:

• Paid campaign landing pages — Match the ad creative to the product page
• Audience segmentation — Different messaging for different user segments
• A/B testing — Test different value propositions
• Seasonal campaigns — Holiday or event-specific messaging

Each custom product page gets a unique URL that you can use in your marketing campaigns.

Product Page Optimization (A/B Testing)

Apple's built-in A/B testing feature lets you test:

• App icon
• Screenshots
• App preview videos

How it works:

1. Create a treatment with alternative assets
2. Set the traffic allocation (what percentage of users see the test variant)
3. Run the test for a statistically significant duration (typically 7-14 days)
4. Apple shows you the conversion rate difference
5. Apply the winner or continue testing

Tips:

• Test one element at a time for clear results
• Run tests for at least 7 days to account for day-of-week effects
• Focus on the first 3 screenshots (most users don't scroll further)
• Test your icon if conversion rates are low across the board

App Store Connect API

For automated workflows, Apple provides the App Store Connect API:

Common use cases:

• Automated build uploads from CI/CD pipelines
• Programmatic metadata updates
• Bulk pricing changes across territories
• TestFlight management
• Sales and analytics data export
• In-app purchase management

Authentication:

• Uses JWT (JSON Web Token) authentication
• Requires API keys generated in App Store Connect
• Keys are role-based with specific permissions

FAQ

How long does App Review take?

Typically 24-48 hours. During peak periods (before major holidays), it can take up to a week. Track current average times at Apple's status page.

Can I change my app name after publishing?

Yes, but only with a new version submission. Name changes go through App Review. Keep in mind that changing your name affects your search rankings — don't change it frequently.

How do I transfer an app to another developer account?

Use the App Transfer feature in App Store Connect. Both accounts must meet specific requirements (no pending agreements, no iCloud entitlements in certain configurations, etc.).

What's the difference between Promotional Text and Description?

Promotional Text (170 characters) can be updated anytime without a new version or review. Description (4,000 characters) requires a new version submission. Use Promotional Text for timely messaging.

How do I respond to app reviews?

Go to My Apps → select your app → Ratings and Reviews → click "Reply" on any review. Your response is public and visible to all users. Be professional, helpful, and concise.