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 screen, and within each screen there will be a section for each device layer.
   
   

3. If you are localising your screenshots into other languages, you’ll see 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 toolbar.
   
   

5. Drag and drop your raw app screenshots from your file manage onto their associated target box, or click on the box to navigate to the screenshot via your file manager and upload. If you have already uploaded your raw app screenshot, click on the image icon and select your screenshot from your AppScreens file manager.
   
   You can also drag and drop between devices to upload the same screenshot for another device. To do this, click on the move icon and drag & drop to another device.
   
   

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 raw app screenshots from a structured folder, where we can detect the natural order, language and aspect ratio in accordance with your required screenshots. We also support exports from Fastlane (capture_ios_screenshots & capture_android_screenshots).

Import in smaller batches for best accuracy: Select only the outputs and languages you are importing in this pass. We now match exact sizes first, then fall back to aspect matching, so broad selections can still create ambiguity when multiple targets are valid. If sizes/languages are ambiguous, or if you want to reuse the same files across multiple device groups, run import multiple times with tighter selections. Leaving some files unassigned is normal; you leave them unassigned, or assign them manually afterward.

Raw Screenshot Order: Files are sorted using a "natural sort" to order them as logically as possible. For best results, please ensure these have uniform file conventions (i.e. 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 displayed in your project. This must be prefixed & suffixed by a non-alphanumeric value (i.e. '/iphone-en-', 'en_', etc.).

Aspect Ratio: File dimensions and aspect ratios are automatically calculated. This tool expects the correct amount of screenshots for your project, these must be in accordance with the output devices selected in your project. If the Aspect Ratio's will clash between iOS and Android, either import separately or order files so that Android is 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 Bulk upload raw screenshots in the bottom left corner.
   
   

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

5. Select the outputs, screenshots and languages in your folder. Smaller, targeted imports are often easier to verify.
   
   

6. Click Select folder and scan raw screenshots to choose the folder containing your screenshots.
   
   

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

8. Review the results carefully and make sure files have been assigned to the correct languages, screenshots, and devices before continuing. You can use the drop down to select and change any images that have been incorrectly assigned.
   
   

9. If the results are not what you expected, click Abort & import again and check that your folder structure is correct before re-uploading.
   
   

10. Once all screenshots have been assigned correctly, click Import assigned screenshots.

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.