How to upload raw app screenshots

Single Screenshot Upload

1. In the top toolbar, click on the App Screens button.
   
   

2. This will open the screenshot uploader. Across the top bar, you will see each screenshot, and within each screenshot there will be a section for each layer.
   
   

3. If you are localising your screenshots into other languages, there will be a language dropdown in the top right of the screenshot uploader.
   
   

4. Upload a raw screenshot of your app for each device. You can upload one Global Screenshot for your selected target devices but it is not recommended (see warning below).
   
   Note: These targets are set during the initial project setup and can be edited at any time by clicking Setup in the top actions panel.

   WARNING: To comply with App Store guidelines, your screenshots must accurately represent the devices they are intended for. Apple may reject submissions if the screenshots do not show your app on the correct device type.
   

   To avoid rejections, we recommend capturing screenshots directly from the specific devices, simulators, or emulators that match the target screen sizes. For example, iPad screenshots should be taken on an iPad or in an iPad simulator. This helps ensure your app is accurately represented across all devices.

5. You can drag and drop your raw app screenshots onto their associated target box or click on the box to navigate to the screenshot via your file manager and upload.
   
   You can also drag and drop between devices to upload the same screenshot for another device. To do this, click on the blue image icon and drag & drop to the right of the purple upload icon.
   
   

6. Once your screenshots have been uploaded, click Save to close the uploader and refresh your screenshots.

Bulk Folder Screenshot Upload

You can import all screenshots from a structured folder. AppScreens can detect the natural order, language, and aspect ratio based on your required screenshots. We also support Fastlane exports, including capture_ios_screenshots and capture_android_screenshots.

Screenshot Order: Files are sorted using a "natural sort" to order them as logically as possible. For best results, use a consistent file naming convention for example; prefix 0 for 01 through to 10. If you have multiple devices in a single screenshot, these are imported from bottom to top.

Language: Denote languages using the code shown in your project. The code must be prefixed and suffixed by a non-alphanumeric character, such as /iphone-en- or en_.

Aspect Ratio: File dimensions and aspect ratios are calculated automatically. This tool expects the correct number of screenshots for your project, based on the output devices selected in your setup. If aspect ratios clash between iOS and Android, either import them separately or order the files so Android comes first, then Apple, then any extras.

 

1. In the top toolbar, click the App Screens button.
   
   

2. This will open the screenshot uploader. Across the top bar, you will see each screenshot, and within each screenshot there will be a section for each layer.
   
   

3. Click Upload folder in the bottom left corner.
   
   

4. Read through the setup guidance and examples so your folder is structured correctly.
   
   

5. Click Select folder and choose the folder containing your screenshots.
   
   

6. AppScreens will sort and assign screenshots to the corresponding output sizes.
   
   

7. Review the results carefully and make sure files have been assigned to the correct languages, screenshots, and devices before continuing. If the results are not what you expected, click Abort & import again and check that your folder structure is correct before re-uploading.
   
   

8. Once all screenshots have been assigned correctly, click Import assigned files.
   
   

9. You can use bulk upload again later if needed. You do not have to re-import your entire library every time. If only a few screenshots have changed, you can update just those screens instead of uploading everything again.

Updating Screenshots

You can reopen the screenshot uploader at any time and upload more screenshots or replace existing ones. You do not need to upload your entire set again.

For example, if one raw app screen changes after an update, you can upload just that screenshot for the relevant languages or devices while keeping everything else unchanged.