<!--
{
  "documentType" : "article",
  "framework" : "AppStoreConnectAPI",
  "identifier" : "/documentation/AppStoreConnectAPI/app-previews",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "App Previews"
}
-->

# App Previews

Upload and download app previews for an app locale and display target.

## Discussion

An `appPreviews` resource represents a single app preview for an app locale and display target. Use this resource to:

- Upload new app previews to App Store Connect.
- Download existing app previews.
- Set a custom timestamp for the preview’s poster frame.

To upload app previews, begin by creating an [App Preview Sets](/documentation/AppStoreConnectAPI/app-preview-sets) resource for the locale and display target. For more information, see [App preview specifications](https://developer.apple.com/help/app-store-connect/reference/app-preview-specifications).

## Topics

### Listing App Previews and Reading Information

[`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.

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

Get information about an app preview and its upload and processing status.

### Creating, Modifying, and Deleting App Previews

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

Add a new app preview to a preview set.

[`Modify an app preview`](/documentation/AppStoreConnectAPI/PATCH-v1-appPreviews-_id_)

Commit the app preview after uploading it, and update the poster frame timecode.

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

Delete an app preview within a preview set.

### Objects and Data Types

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

The data structure that represent an App Previews resource.

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

The request body you use to create an App Preview.

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

The request body you use to update an App Preview.

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

The response body for endpoints that create, read, or modify an app preview video.

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

The response body for endpoints that list app preview videos in a preview set.

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

Upload instructions for assets such as app previews and app screenshots.

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

String that represents the display type of an app preview.

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

The properties that describe a preview frame image for an app preview or app event video.

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

The properties that describe the state of an app preview or app event video.

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

The properties that describe the state of a preview frame image for an app preveiew or app event video.


---

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)