Each row links to the platform's own documentation. Values are quoted as published — not rounded, not paraphrased. Platforms change specs; the linked page always wins over this table.
| Field | Requirement | Source |
|---|---|---|
| Aspect ratio (product video — recommended) | "The aspect ratio should be one of the following: 16:9, 9:16, 4:3, 3:4, 1:1" (listed under "Recommended video specifications", i.e. recommended, NOT enforced) | help.shopify.com |
| Aspect ratio (product video — enforced) | No aspect ratio appears in the mandatory video requirements table. The only enforced shape constraint is "Minimum width and height: 100 pixels" and "Maximum width and height: 4096 pixels" | help.shopify.com |
| Aspect ratio (images — enforced) | "Between 100:1 and 1:100" | help.shopify.com |
| Aspect ratio (images — guidance) | "use a consistent aspect ratio, or height-to-width ratio, for all the images" — no specific ratio mandated | help.shopify.com |
| Max duration (product video) | "Maximum video length of 10 minutes" | help.shopify.com |
| Min duration (product video) | "Minimum video length of 0.25 seconds" | help.shopify.com |
| Max file size (product video) | "Maximum of 1 GB (gigabyte)" | help.shopify.com |
| Max resolution (product video) — help center requirements table | "Maximum resolution of UHD"; "Maximum width and height: 4096 pixels" | help.shopify.com |
| Max resolution (product video) — CONFLICTING help center page | "Up to 4K (4096 x 2160 px)" | help.shopify.com |
| Max resolution (product video) — CONFLICTING dev docs | "Max 3840x2160 (UHD/4K)" | shopify.dev |
| Min dimensions (product video) | "Minimum width and height: 100 pixels" | help.shopify.com |
| Max frame rate (product video) | "Maximum frame rate: 120 frames per second" | help.shopify.com |
| Recommended frame rates (product video) | "60 fps", "30 fps", "25 fps" | help.shopify.com |
| Accepted containers (product video) | "MOV, MP4, and WEBM" | help.shopify.com |
| Accepted codecs (product video) | "Video: H.264 (AVC), Audio: AAC, MP3, Opus" | help.shopify.com |
| Supported color spaces (product video) | "Rec.601", "Rec.709", "Rec.2020" | help.shopify.com |
| Recommended resolutions (product video) | "3840x2160 (UHD)", "1920x1080 (1080p)", "1280x720 (720p)", "854x480 (480p)" — plus "Vertical orientation for the above resolutions are also recommended, e.g., 720x1280 px" | help.shopify.com |
| Recommended bitrates — HLS (product video) | "SD 480: Range from 900 kbps to 2800 kbps"; "HD 720: Range from 2000 kbps to 6500 kbps"; "HD 1080: Range from 3200 kbps to 10400 kbps" | help.shopify.com |
| Recommended bitrates — MP4 (product video) | "SD 480: Range from 0.9 Mbps to 1.5 Mbps"; "HD 720: Range from 1.6 Mbps to 4.5 Mbps"; "HD 1080: Range from 2.5 Mbps to 7.2 Mbps" | help.shopify.com |
| Delivery / transcoding (storefront playback) | "Shopify converts and serves all videos as .mp4 or HLS format for optimal compatibility to customers." and "In browsers that support streaming, videos display in either 480p, 720p, or 1080p, depending on the viewer's connection speed and the resolution of the uploaded video." — i.e. storefront playback caps at 1080p even if you upload UHD | help.shopify.com |
| Video cover image / thumbnail | "When you add 3D models and videos to your products, thumbnails are created for them automatically. You can replace the default thumbnails with images of your choice." — NO dimension, aspect-ratio, file-size or format requirement is stated anywhere on the thumbnail page; the replacement is picked from existing store files, so the general image limits apply | help.shopify.com |
| Max file size (images) | "Maximum of 20 MB (megabytes)" | help.shopify.com |
| Max resolution (images) — help center requirements table | "Maximum of 20 MP (megapixels)" | help.shopify.com |
| Max resolution (images) — CONFLICTING help center page | "any size up to 5000 x 5000 px, or 25 megapixels" (note: 5000 x 5000 = 25 MP, which exceeds the 20 MP cap stated on the file-uploads page) | help.shopify.com |
| Max resolution (images) — CONFLICTING dev docs | "Max 20 MB Max 4472 x 4472 px (20 MP) Recommended: 2048 x 2048 px" | shopify.dev |
| Max resolution (images) — theme images page (self-contradictory) | States maximum "20 megapixels" and max file size "20 megabytes", but also recommends uploading "up to 5000px x 5000px or 25 megapixels" on the same page | help.shopify.com |
| Accepted image formats — file-uploads requirements table | "JPEG, PNG, WEBP, HEIC, and GIF" | help.shopify.com |
| Accepted image formats — CONFLICTING (broader list) | "PNG, followed by JPEG. Other accepted file types are PSD, TIFF, BMP, GIF, SVG, HEIC, and WebP"; also "Animated versions of GIF and WebP files are also supported" | help.shopify.com |
| Recommended product image size | "For square product images, a size of 2048 x 2048 px usually displays best." | help.shopify.com |
| Max media items per product (GOTCHA) | "You can add a maximum of 250 images, 3D models, or videos to a product." — combined cap across all media types, not per type | help.shopify.com |
| External (hosted) video — accepted platforms & permissions (GOTCHA) | YouTube and Vimeo only. "Videos must have permissions that allow them to be accessed publicly or embedded on external websites." YouTube: "set the video to Public or Unlisted". Vimeo: "ensure the video allows embedding on external sites". No file size, duration or resolution limit applies to externally hosted video. | help.shopify.com |
| External video — required URL formats (GOTCHA) | YouTube: "Use the standard video URL format https://youtube.com/watch?v=[video-id]". Vimeo: "Use the direct video URL format https://vimeo.com/[video-id]". Short/share URLs are not the documented format. | help.shopify.com |
| Filename rule (GOTCHA) | "File names can contain letters, numbers, spaces, and symbols, but must not begin with a period (.)" — additionally avoid filenames ending in pico, icon, thumb, testing, small, compact, medium, large, grande (these collide with Shopify's image-size suffixes) | help.shopify.com |
| Theme support requirement (GOTCHA) | To display 3D models or videos, the store must use "a theme that supports 3D models and videos" or the current theme's code must be modified — uploading media is not sufficient for it to appear on the storefront | help.shopify.com |
| 3D model file size and formats | "Up to 500 MB"; formats "GLB, USDZ". "If you upload a 3D model file that exceeds 15 MB, then your file is automatically optimized." Shopify serves both GLB (web) and USDZ (iOS AR). | help.shopify.com |
| Generic (non-media) file limits | "Maximum of 20 MB"; "Any file type except HTML" | help.shopify.com |
| API video creation rate limit (GOTCHA for bulk uploaders) | "Apps can create up to 1,000 videos for each store in a week." | shopify.dev |
SOURCES FETCHED SUCCESSFULLY (all first-party): help.shopify.com file-uploads (the authoritative requirements page), help.shopify.com product-media, product-media-types, add-media, change-thumbnail, online-store/images/theme-images, and shopify.dev/docs/apps/build/online-store/product-media. Nothing was taken from a blog. The two most contentious extractions (the 16:9/9:16/4:3/3:4/1:1 aspect-ratio list and the H.264/AAC codec line) were re-fetched a second time with a strict literal-quote prompt to confirm they genuinely appear on the page rather than being inferred. IMPORTANT — ENFORCED vs RECOMMENDED. Shopify's video aspect-ratio list is under a heading literally titled "Recommended video specifications". It is NOT an upload gate. The mandatory video requirements table contains no aspect ratio at all; the only hard shape constraint is min width/height 100 px and max width/height 4096 px. So a 21:9 or 2:1 video will upload fine — it just isn't in Shopify's recommended set. Do not present the ratio list as a hard requirement. OFFICIAL PAGES DISAGREE — THREE SEPARATE CONFLICTS, all recorded above rather than resolved: 1. Image max resolution. file-uploads says "Maximum of 20 MP". product-media-types says "up to 5000 x 5000 px, or 25 megapixels". shopify.dev says "Max 4472 x 4472 px (20 MP)". 4472x4472 is exactly 20 MP and is consistent with the file-uploads cap; 5000x5000 is 25 MP and exceeds it. The theme-images page contradicts itself on a single page, stating a 20 MP maximum while recommending uploads "up to 5000px x 5000px or 25 megapixels". Safest working number is 20 MP / 4472 x 4472 px, but note that is my reconciliation, not a Shopify statement. 2. Video max resolution. file-uploads says "Maximum resolution of UHD" with max width/height 4096 px. product-media-types says "Up to 4K (4096 x 2160 px)". shopify.dev says "Max 3840x2160 (UHD/4K)". UHD is 3840x2160; 4K DCI is 4096x2160. The 4096 px dimension cap and the 3840x2160 resolution cap are not the same claim. 3. Accepted image formats. file-uploads lists only "JPEG, PNG, WEBP, HEIC, and GIF". product-media-types lists a broader set adding PSD, TIFF, BMP, and SVG. The broader list likely reflects formats accepted at upload and converted, versus formats served; Shopify does not say which, so both are recorded. COVER IMAGE / THUMBNAIL — GENUINE GAP. Video and 3D-model thumbnails are auto-generated and can be replaced from the product editor (pencil icon next to the cover image), but Shopify publishes no dimension, aspect-ratio, file-size or format requirement specific to that replacement image. I verified this by pulling the change-thumbnail page verbatim; it is a six-step procedure with zero specs. The general image limits (20 MB, 20 MP, 100:1–1:100) are the only published constraints that can apply. I have not filled this gap with a guessed number. SURFACE MODEL — Shopify is not like Reels/Shorts. There is no feed/Reels/listing-main-image split and no safe-zone or UI-overlap guidance published anywhere, because product media renders inside the merchant's own theme rather than a fixed platform chrome. The real surface-level variable is the theme: media will not display at all unless the theme supports 3D models and video. Crop and framing are therefore theme-dependent, and Shopify's only framing advice is to keep a consistent aspect ratio across a product's images. Do not expect an Amazon-main-image-style duration window or a Reels-style safe zone here — none exists. PLAYBACK CEILING WORTH FLAGGING TO CREATORS. Even though uploads up to UHD are accepted, storefront delivery is capped: videos display at 480p, 720p, or 1080p depending on connection and source. Mastering above 1080p buys nothing on the storefront today. CHANGE HISTORY — NOT ESTABLISHED. I could not verify whether any of these numbers changed in the last twelve months. Shopify does not version or date-stamp these help pages, and my web search budget for this session was exhausted before I could check the changelog or archived copies, so I could not diff against earlier versions. Treat "no recent change" as unknown, not as confirmed-stable. The 0.25 second minimum duration and the 120 fps cap are the specs most likely to be recent additions, since they read like pipeline-validation limits, but I have no evidence for that and it should not be repeated as fact. METHOD CAVEAT. Page content was retrieved through a fetch-and-extract step, so values are quoted as that extraction returned them. Every number above is presented in the wording attributed to its page, and the high-risk items were double-checked, but for anything load-bearing in a production upload validator I would re-read the file-uploads page directly before hardcoding.
Platforms can change them at any time. Every row here links to the source, so if something looks off, the linked page wins — and tell us. Checked: 2026-07-25.
Aspect ratio and duration are chosen before generating, and templates come preset to common platform ratios. Delivery parameters like codec, container and file size depend on what you do after export; this page lists the requirements so you can check them.
Yes. The template library includes a cross-platform adaptation that recomposes one key visual into 1:1 / 9:16 / 16:9 rather than cropping it.