Screenhance

How to Upload Screenshots to App Store Connect

Upload through App Store Connect's web interface, or organize a repeatable fastlane workflow for a larger set. This guide covers both routes and the checks to make before either one.

4.9 · 2,000+ ratings

Loved by 3,000+ creators

App Store Connect accepts screenshots two ways: the web uploader and the API. The web uploader is direct and visible. A fastlane workflow can reduce repetitive uploads across several supported device slots and localizations. Neither route fixes the source files: prepare the selected Apple size presets, inspect each layout, and verify the final files against the current slot before uploading.

The manual uploader, step by step

  1. 1. In App Store Connect, open your app and select the version you are preparing for submission.
  2. 2. Scroll to Previews and Screenshots and choose one of the device slots shown for the submitted build.
  3. 3. Add the images in the order you want people to encounter them and preview the resulting sequence.
  4. 4. Switch language at the top of the page and repeat for every localization you ship.
  5. 5. Repeat the whole thing for each additional device size you support.

The manual route is often enough for a small release. A repeatable upload workflow becomes useful when you maintain several supported device slots and localizations. Before submission, check Apple's current upload instructions.

The fastlane way

fastlane deliver can deliver a screenshot directory to App Store Connect. Its metadata structure groups images in locale folders such as en-US, de-DE, or zh-Hans and uses the file dimensions to map screenshot types. Review fastlane's current setup and command options before using it in a release pipeline.

Screenhance can organize selected device-size and locale exports into that folder structure. Review every generated file, then place the resulting folders in the fastlane screenshots directory used by your project.

For the Screenhance export controls and the checks to make after transfer, follow the step-by-step App Store Connect upload guide. It covers the standard ZIP, Fastlane folders, and direct upload when your export panel offers it.

Using the App Store Connect API directly

If you need direct automation, use Apple's current App Store Connect API documentation. Screenshot asset upload, authentication, permissions, and version relationships are implementation details that should be read from Apple at the time you build the integration. Keep private keys out of source control and use the narrowest role your workflow supports. Start with Apple's App Store Connect API documentation.

Screenhance prepares organized screenshot files and optional locale folders for App Store Connect or fastlane. Use direct upload when it is available for your iOS configuration, or publish through Apple's workflow with the organized ZIP.

Frequently Asked Questions

How do I upload screenshots to App Store Connect?

In App Store Connect, open the app version you are preparing, find Previews and Screenshots, choose one of the device slots shown for that build, and add the images in order. Repeat for the supported device slots and localizations you intend to publish. Check Apple's current upload guidance before submission.

Can I upload App Store screenshots through the API?

Yes. Apple provides App Store Connect API endpoints for screenshot assets, and fastlane deliver can automate screenshot delivery. Authentication, roles, and API behavior can change, so use Apple's and fastlane's current documentation rather than copying credentials or commands from an old guide.

What folder structure does fastlane deliver expect?

fastlane's metadata structure uses a screenshots directory with locale folders such as en-US, de-DE, or zh-Hans. Screenhance can organize selected size and locale exports into that layout. Check fastlane's current deliver documentation before running an upload.

How many screenshots can I upload per size?

Apple currently allows from one to ten screenshots per supported device size and localization. Use only the images needed to explain the product clearly, place the most important message early, and review the final order in App Store Connect.

Why does App Store Connect reject my screenshots on upload?

Read the error shown in App Store Connect first. For a dimension error, compare the failed file with Apple's current accepted pixel pairs for that device slot and re-export it exactly. Also keep the images truthful to the submitted product and review Apple's current submission rules.

Export screenshots App Store Connect will accept

Build the set, choose the device slots and locales needed for the release, inspect the files, then upload through App Store Connect or your own fastlane workflow.