Storeboard/Blog/Asset Library

The App Store Connect Asset Library, explained

Reference 31 October 2026 · 9 min read

Until October, every screenshot belonged to one screenshot set on one version in one language. Upload the same image for ten languages and App Store Connect kept ten copies. The Asset Library splits the file from where it appears. That's a bigger change than it looks, and it explains most of the new rules about deleting, archiving and review. Everything here is from Apple's help pages and API documentation, checked on 31 October 2026, plus what we learned building Asset Library publishing into Storeboard.

Where is the Asset Library?

In App Store Connect, open Apps, pick your app, and click Asset Library in the sidebar. The + button offers Upload Creative Assets or Previews and Screenshots. You can filter the list by type, status and format. Apple's help says you need the Account Holder, Admin, App Manager or Marketing role to manage assets (Manage your App Store assets).

What goes in the Asset Library

Every asset has one of two categories, chosen when it's uploaded and fixed after that. The category decides which placements it can fill:

Creative assets are new, optional, and appear on iOS 27 and iPadOS 27 and later. Apple's sizes for them, from the creative assets specifications:

Images can't have transparency. Videos run at 30 or 60 fps as .mov, .m4v or .mp4, loop, and start muted. Our guide to header and search results images covers the content rules and how the 16:9 universal image crops in each slot.

Assets and placements: the one idea to get

An asset is a file you uploaded. A placement puts that asset in one slot, for one device group, in one language, on one surface. Apple's API documentation describes the parts like this:

• Per language. A placement targets one localization. A header in 12 languages is 12 placements: of one language-neutral asset, or of 12 localized ones. Apple asks you to localize creative assets for every language your app supports, so plan on the second.
• Placements are fixed. You can't swap the image inside a placement. To show a new one, remove the placement and place the new asset. The old asset stays in the library.
• Each slot has a cap. On a version, Apple's documentation gives 10 screenshots, 3 app previews and 1 product page header per device group. Each In-App Event slot takes a single asset. Custom product pages and tests have their own limits.
• Assets don't change. You can rename an asset or change a video's poster frame, but not the file. A new picture is a new upload.

Asset Library statuses

From Apple's App Store asset statuses, with the API's name for each where it differs:

The API adds one more, FAILED, for a file that didn't process. Its stateDetails say why. Placements have states of their own that follow the surface they sit on, from ASSET_PROCESSING to PARENT_APPROVED.

Submit assets without a new app version

This is the most useful part for most developers: once your app has an approved version, you can get creative assets approved on their own and change your header without shipping an update. From Submit assets from Asset Library:

1. In the Asset Library, click Edit, select the assets, then Add for Review.
2. Add them to a draft submission or start a new one. Assets with no version are reviewed against the latest version for the platform you choose.
3. Click Submit for Review in the Draft Submission pane.

Once an asset is approved, open the version that's live on the App Store, then Header and Search Results ▸ Header (or Search Results) ▸ Browse Assets, choose it, click Next and Publish. Your product page updates with no new build.

Three rules decide whether an asset can go on its own:

• First version first. A brand-new app's assets go in with its first version.
• Assigned assets travel with their parent. Anything placed on a version, custom product page, test or In-App Event is reviewed with that item, not separately.
• Not while the parent is in review. An asset can't be submitted alone if the item it's assigned to is already in an active submission.

Apple's submit page lists only the Account Holder, Admin and App Manager roles. Marketing is listed for managing assets but not for submitting them, so a Marketing user may need a colleague to send them for review.

How to reorder screenshots in the Asset Library

Order belongs to the placements, not the assets, and it's set per device group per language. In App Store Connect, reorder on the version's Product Page Information, or in the Media Manager (View All Sizes), which also lets you add assets from the library and remove placements. Through the API, one ordering request per group and language lists the placements in display order. In-App Event slots hold one asset each, so there's nothing to order.

Archive or delete?

Apple notes that an archived asset may come back on its own when a new version of a placement carries it over. The status page also uses Archived for assets that belonged to a previous version and were replaced, so not every archived asset is one you archived.

Removing an asset from a placement (the Delete button on the version's Header and Search Results tab, or the – button in the Media Manager) takes it off the App Store but leaves it in the library.

iPhone Duo screenshots and the Asset Library

On 9 September 2026 Apple added the iPhone Duo screenshot sizes and said uploading would come "later this year". On 5 October, the same day the Asset Library launched, it began accepting iPhone Duo optimized apps. Duo screenshots are previews-and-screenshots assets, placed in a device group whose display class is IPHONE_DUO:

• Sizes: 2007 × 2853 open and 1398 × 2034 folded, each also in landscape (2853 × 2007 and 2034 × 1398). Up to 10 per size, like every other device.
• Required: from April 2027, for apps using the iOS 27.1 SDK or later. Submitting them earlier adds an optimized-for-iPhone-Duo badge to your product page.
• Through the API: the Asset Library is the only route. The older screenshot set resource has no iPhone Duo display type, and Apple has deprecated it.

Apple's help pages don't yet say which screen shows the Duo sizes. The Media Manager (View All Sizes) is where App Store Connect manages every device size per language, so look there and in the Asset Library. Design guidance is in our iPhone Duo screenshots guide.

What you can do through the App Store Connect API

Version 4.5.1 of the API added the Asset Library. Checked against Apple's OpenAPI specification:

The endpoints and request bodies, step by step, are in our App Store Connect API Asset Library guide. If something's stuck or refused, see Asset Library errors and fixes.

Publishing to the Asset Library from Storeboard Coming soon

Storeboard 1.3 designs the header, search results and universal images and iPhone Duo screenshot sets in every language, and publishes them to the Asset Library with your own App Store Connect API key: one placement per slot per language, with Duo groups read from Apple's reference data rather than hard-coded. It isn't on the App Store yet: today's version is 1.1.6, and 1.3 arrives as an update. See what's coming in Storeboard 1.3.

FAQ

Keep reading