Upload Store Screenshots | FlightStack

Upload Store Screenshots

Pushes the approved screenshot set from ScreenStack to the relevant store consoles — App Store Connect (iOS) and Google Play Console (Android) — so a marketing release ships with the same visuals your CI captured.

Step ref: flightstack/upload-store-screenshots@1.0.0.

Requirements

A successful ScreenStack job upstream (or a manual approval that points to a ScreenStack review).
Code-signing credentials for the destination store(s):
- App Store Connect API key — see Code signing.
- Google Play service account with at least the Release manager role.
A draft / next release in the destination store. (Apple requires a Prepare for Submission version; Google Play requires a track-level release.)

Configuration

Option	Description	Default
Targets	`app-store`, `play-store`, or both	required
App Store Connect key	Credential ID	required for App Store
Play Store service account	Credential ID	required for Play
Locale	App Store locale (e.g. `en-US`, `de-DE`)	`en-US`
Device families	`iphone-65`, `iphone-67`, `ipad-13`, `pixel`, `tablet`	all available
Replace existing	Replace screenshots already in the destination version	`true`
Source review	ScreenStack review ID	upstream output

Outputs

Name	Description
`iosUploaded`	Count of screenshots uploaded to App Store Connect.
`androidUploaded`	Count of screenshots uploaded to Play Console.
`appStoreUrl`	Deep link to the App Store Connect submission.
`playConsoleUrl`	Deep link to the Play Console listing.

Example pipeline

┌────────────┐    ┌────────────┐    ┌──────────────┐    ┌────────────────────────┐
│ On Tag     │───▶│ Build iOS  │───▶│ Screen Stack │───▶│ Approval               │
│ v*         │    │            │    │              │    │ "ship screenshots?"    │
└────────────┘    └────────────┘    └──────────────┘    └────────────────────────┘
                                                                  │
                                                                  ▼
                                                        ┌──────────────────────┐
                                                        │ Upload Store         │
                                                        │ Screenshots          │
                                                        └──────────────────────┘

Troubleshooting

Apple rejects screenshots (“dimensions do not match”) Apple’s requirements change over time. ScreenStack device profiles ship with the current required dimensions — make sure your devices list matches the App Store version’s required device families.

Play Console rejects “incomplete localization” Play Console requires all configured locales to have screenshots. Either upload to every locale (set Locale to a comma-separated list) or remove the empty locales from the listing.