Sizes

You design a set once per device: once for the iPhone, once for the iPhone Duo, once for the iPad and once for the Mac. The export then holds that design at the exact pixel size of every display App Store Connect lists, each in a folder of its own.

Every file is a PNG without transparency. iPhone and iPad sets are portrait, and a Mac set is landscape.

Screenshots#

The folder name is also the id of the size, which agents and the API use.

What an export holds#

The sizes marked Always, for every device the project has screenshots of:

A project without any screenshots yet counts as an iPhone project.

The other sizes are for displays Apple no longer sells, and the three smaller sizes the Mac App Store takes besides its largest. App Store Connect fills a display you leave empty from a larger one, and a Mac app needs one size only, so most apps never need them. To add or drop sizes, tick them under Project → Export sizes in the Studio, or set the project's targets:

{ "project": "streaks", "targets": ["iphone-6.9", "iphone-6.3", "iphone-5.5"] }

An empty list goes back to the standard sizes.

One design, many sizes#

Displays of the same shape get the same picture. The slide is drawn once at the largest size and scaled to the others, so a headline breaks on the same word and the device sits in the same place on every one of them.

iphone-3.5, iphone-duo, iphone-duo-cover and ipad-11 have a shape of their own and are drawn on their own. The layout is the same and follows the shape.

Which device a screenshot counts as#

Each raw screenshot belongs to one device:

A picture at the exact size of an iPhone or iPad screenshot stays with that device when it is turned on its side.

The iPhone Duo is told by its exact size because its shape is close to an iPad's. When a screenshot lands under the wrong device, change it with the small menu on its thumbnail under Assets in the Studio, or say it at upload: appshots upload streaks home.png --as duo. --as takes iphone, duo, ipad and mac.

Upload each device's screenshot under the same name. A slide that uses home then shows the iPhone home on iPhone sizes, the Duo home on Duo sizes, the iPad home on iPad sizes and the Mac home on the Mac size. If a device has none of its own, the closest other one stands in, and the render says so.

Raw screenshots#

Any resolution from 300 pixels on the short side works. The screenshot is scaled to the device's screen. For the sharpest result, capture on the simulators the largest sizes are made for: an iPhone Pro Max, the iPhone Duo and the 13-inch iPad Pro. appshots run picks them for you. A Mac app is captured from its own window. See Mac apps.

Header and search results#

These are the largest sizes App Store Connect accepts for them. See Header and search results.

Banners#

Wide pictures for outside the store. See Banners.

What appShots does not make#

Landscape screenshots of an iPhone or iPad app, app previews (videos), and Apple Watch, Apple TV or Vision Pro sizes.