Video Previews

Manage App Store app preview videos

Manage app preview videos for your App Store listings.

Overview

The video-previews command allows you to upload, list, download, and delete app preview videos that showcase your app’s features in the App Store. List all app preview videos for a version localization:

asc video-previews list --version-localization "LOC_ID"

The response includes preview sets organized by device type, with details about each video preview including upload state and preview frame time.

Upload Video Previews

Upload app preview videos to App Store Connect:

# Upload single video file
asc video-previews upload --version-localization "LOC_ID" \
  --path "./preview.mov" \
  --device-type "IPHONE_69"

# Upload all videos from directory
asc video-previews upload --version-localization "LOC_ID" \
  --path "./previews" \
  --device-type "IPHONE_69"

Video File Requirements

Format:

Container: MOV or M4V
Codec: H.264 or HEVC (H.265)
Audio: AAC or PCM
Resolution: Must match device-specific requirements

Duration:

15-30 seconds recommended
Maximum 30 seconds

File Size:

Maximum 500 MB per video

Device-Specific Resolutions:

Device Type	Resolution	Aspect Ratio
IPHONE_69	1290 × 2796	9:19.5
IPHONE_67	1284 × 2778	9:19.5
IPHONE_65	1242 × 2688	9:19.5
IPHONE_61	1179 × 2556	9:19.5
IPHONE_58	1170 × 2532	9:19.5
IPAD_PRO_3GEN_129	2048 × 2732	3:4
IPAD_PRO_129	2048 × 2732	3:4

Upload Process

The CLI handles the multi-step upload process automatically:

Creates or finds the appropriate preview set for the device type
Reserves the app preview resource
Uploads the video file to Apple’s CDN
Commits the upload
Polls for processing completion

Example Output:

{
  "version_localization_id": "LOC_ID",
  "set_id": "SET_ID",
  "preview_type": "IPHONE_69",
  "results": [
    {
      "preview_id": "PREVIEW_ID",
      "file_path": "./preview.mov",
      "state": "COMPLETE",
      "uploaded_bytes": 15728640
    }
  ]
}

Download Video Previews

Download existing app preview videos from App Store Connect:

asc video-previews download --version-localization "LOC_ID" \
  --output-dir "./previews/downloaded"

This command:

Downloads all preview videos for the specified localization
Organizes files by device type
Preserves video metadata

Delete Video Previews

Remove an app preview video:

asc video-previews delete --id "PREVIEW_ID" --confirm

Note: The --confirm flag is required to prevent accidental deletions.

Device Type Reference

iPhone Device Types:

IPHONE_69 - iPhone 6.9” (iPhone 15 Pro Max, iPhone 16 Pro Max)
IPHONE_67 - iPhone 6.7” (iPhone 15 Plus, iPhone 16 Plus)
IPHONE_65 - iPhone 6.5” (iPhone XS Max, iPhone 11 Pro Max)
IPHONE_61 - iPhone 6.1” (iPhone 14, iPhone 15)
IPHONE_58 - iPhone 5.8” (iPhone X, iPhone XS)
IPHONE_55 - iPhone 5.5” (iPhone 8 Plus)

iPad Device Types:

IPAD_PRO_3GEN_129 - iPad Pro 12.9” (3rd gen and later)
IPAD_PRO_129 - iPad Pro 12.9” (1st and 2nd gen)
IPAD_PRO_11 - iPad Pro 11”
IPAD_105 - iPad 10.5”
IPAD_97 - iPad 9.7”

Complete Example Workflow

# 1. Check existing previews
asc video-previews list --version-localization "LOC_ID" --output table

# 2. Upload iPhone preview
asc video-previews upload --version-localization "LOC_ID" \
  --path "./marketing/iphone-preview.mov" \
  --device-type "IPHONE_69"

# 3. Upload iPad preview
asc video-previews upload --version-localization "LOC_ID" \
  --path "./marketing/ipad-preview.mov" \
  --device-type "IPAD_PRO_3GEN_129"

# 4. Verify uploads
asc video-previews list --version-localization "LOC_ID"

Video Creation Best Practices

Content Guidelines

Show actual app functionality - Use real app screens and interactions
Start with impact - Capture attention in the first 2-3 seconds
Highlight key features - Focus on your app’s unique value proposition
Use smooth transitions - Avoid jarring cuts or effects
No audio required - Many users watch with sound off

Technical Tips

Recording:

# Record iPhone simulator at correct resolution
xcrun simctl io booted recordVideo --codec=h264 preview.mov

Converting Formats:

# Convert to required specs using ffmpeg
ffmpeg -i input.mp4 -vf scale=1290:2796 \
  -c:v libx264 -pix_fmt yuv420p \
  -c:a aac -b:a 128k \
  output.mov

Verify Resolution:

# Check video dimensions
ffprobe -v error -select_streams v:0 \
  -show_entries stream=width,height \
  -of csv=s=x:p=0 preview.mov

Troubleshooting

Upload Fails with Resolution Error

Ensure video resolution exactly matches device type requirements:

# Check current resolution
ffprobe -v error -select_streams v:0 \
  -show_entries stream=width,height \
  -of default=noprint_wrappers=1 preview.mov

# Resolution must match device type exactly
# IPHONE_69 requires: 1290 × 2796

Upload Timeout

For large files or slow connections, increase upload timeout:

export ASC_UPLOAD_TIMEOUT=300s  # 5 minutes
asc video-previews upload --version-localization "LOC_ID" \
  --path "./large-preview.mov" \
  --device-type "IPHONE_69"

Processing Takes Too Long

Video processing on Apple’s servers can take several minutes. The CLI polls automatically, but you can check status manually:

asc video-previews list --version-localization "LOC_ID" --output json

Look for upload_operations with state: "COMPLETE".

Screenshots - Manage app screenshots
Apps - Manage app metadata and versions

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

Video previews

Video Previews

Overview

Upload Video Previews

Video File Requirements

Upload Process

Download Video Previews

Delete Video Previews

Device Type Reference

Complete Example Workflow

Video Creation Best Practices

Content Guidelines

Technical Tips

Troubleshooting

Upload Fails with Resolution Error

Upload Timeout

Processing Takes Too Long

​Video Previews

​Overview

​List Video Previews

​Upload Video Previews

​Video File Requirements

​Upload Process

​Download Video Previews

​Delete Video Previews

​Device Type Reference

​Complete Example Workflow

​Video Creation Best Practices

​Content Guidelines

​Technical Tips

​Troubleshooting

​Upload Fails with Resolution Error

​Upload Timeout

​Processing Takes Too Long

​Related Commands

Video Previews

Overview

List Video Previews

Upload Video Previews

Video File Requirements

Upload Process

Download Video Previews

Delete Video Previews

Device Type Reference

Complete Example Workflow

Video Creation Best Practices

Content Guidelines

Technical Tips

Troubleshooting

Upload Fails with Resolution Error

Upload Timeout

Processing Takes Too Long

Related Commands