<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-preview-sets",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Preview Sets"
}
-->

# App Preview Sets

Create sets of app previews to upload to App Store Connect.

## Discussion

An `appPreviewSets` resource represents a collection of app previews for an app locale and display target; for example, a set of screenshots for the Simplified Chinese listing of your app for an iPhone with a 6.5” display size. Use app preview sets to:

- Begin the process of uploading app previews.
- Reorder app previews after they’re uploaded.

To upload individual previews, uses the [App Previews](/documentation/AppStoreConnectAPI/app-previews) resource.

For more information about app previews, see [App information](https://developer.apple.com/help/app-store-connect/reference/app-information).

## Topics

### Getting Preview Sets and Reading Information

[`Read app preview set information`](/documentation/AppStoreConnectAPI/GET-v1-appPreviewSets-_id_)

Get an app preview set that includes its display target, language, and the previews it contains.

### Creating and Deleting Preview Sets

[`Create an app preview set`](/documentation/AppStoreConnectAPI/POST-v1-appPreviewSets)

Add a new app preview set to an App Store version localization for a specific app preview type and display size.

[`Delete an app preview set`](/documentation/AppStoreConnectAPI/DELETE-v1-appPreviewSets-_id_)

Delete an app preview set and all of its previews.

### Listing and Reordering All Previews in a Set

[`List all app previews for an app preview set`](/documentation/AppStoreConnectAPI/GET-v1-appPreviewSets-_id_-appPreviews)

List all ordered app previews in a preview set.

[`Get all app preview ids for an app preview set`](/documentation/AppStoreConnectAPI/GET-v1-appPreviewSets-_id_-relationships-appPreviews)

Get the ordered app preview IDs in a preview set.

[`Replace all app previews for an app preview set`](/documentation/AppStoreConnectAPI/PATCH-v1-appPreviewSets-_id_-relationships-appPreviews)

Change the order of the app previews in a preview set.

### Objects

[`AppPreviewSet`](/documentation/AppStoreConnectAPI/AppPreviewSet)

The data structure that represent an App Preview Sets resource.

[`AppPreviewSetCreateRequest`](/documentation/AppStoreConnectAPI/AppPreviewSetCreateRequest)

The request body you use to create an App Preview Set.

[`AppPreviewSetResponse`](/documentation/AppStoreConnectAPI/AppPreviewSetResponse)

The response body for endpoints that create or read a set of app preview videos for a display size.

[`AppPreviewSetsResponse`](/documentation/AppStoreConnectAPI/AppPreviewSetsResponse)

The response body for endpoints that list app preview sets for an App Store version localization.

[`AppPreviewSetAppPreviewsLinkagesRequest`](/documentation/AppStoreConnectAPI/AppPreviewSetAppPreviewsLinkagesRequest)

A request body you use to reorder the app previews in a preview set.

[`AppPreviewSetAppPreviewsLinkagesResponse`](/documentation/AppStoreConnectAPI/AppPreviewSetAppPreviewsLinkagesResponse)

A response body that contains a list of related resource IDs.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)