YouTube thumbnail limit: 2 MB on mobile, 50 MB on desktop
YouTube's help page lists a 2 MB thumbnail cap on mobile and 50 MB on desktop. Export a JPEG still from a clip with video_frames and size it to fit.
YouTube's thumbnail page gives two upload caps: 2 MB for a video thumbnail on mobile, and 50 MB for video, Shorts and podcast thumbnails on desktop. So a frame that is fine from a computer can fail from a phone. Export the still as a JPEG and check its size before you upload.
What does YouTube's page say? (read 2026-10-09)
The account must be verified to upload custom thumbnails.
| Item | What the page says |
|---|---|
| Resolution | 3840 x 2160 for videos and 2160 x 3840 for Shorts |
| Minimum | Width 640 px for videos; height 640 px for Shorts |
| Formats | JPG or PNG recommended |
| Size, mobile | 2 MB for video thumbnails |
| Size, desktop | 50 MB for video, Shorts and podcast thumbnails |
| Aspect | 16:9 for videos, 9:16 for Shorts |
| Shorts | Custom Shorts thumbnails can be added only in YouTube Studio on a computer |
How do you pull a frame from your clip?
Import the clip, then call video_frames with one or more times in at[]. The output is a durable image at source size by default, JPEG unless you ask for PNG, and max_edge can clamp the long edge between 16 and 2160. Billing is by the job's Modal compute, so there is no fixed per-frame price.
Because the clamp tops out at 2160, a 9:16 frame cannot be pulled larger than 2160 on its long edge by this route. That is above YouTube's 640 minimum, so it only matters if you want the 2160 x 3840 size the page recommends; then render the thumbnail as an image at that size instead.
How do you stay under 2 MB?
- Keep JPEG (the default); PNG stills of a busy frame are usually much larger.
- Lower max_edge, for example to 1280 for a 16:9 frame, which is still above the 640 px minimum width.
- Check the exported file's size on disk before uploading.
- If you only upload from desktop, the 50 MB cap makes this moot, so keep the large file.
Which frame should you pick?
Pick a frame with the subject clear and the text large enough to read at small size. To view candidates quickly, extract several times at once, then pick one. The label rules are separate; a thumbnail made with AI is covered in YouTube's label rules.
For a Short, remember the page says custom thumbnails for Shorts are added only in YouTube Studio on a computer, so the mobile cap does not apply there. Keep two exports of a chosen frame, one small JPEG for phone uploads and one large file for desktop, and name them so nobody mixes them up.
Sources
Related posts
More in Media tools
- YouTube asks for 4:2:0 chroma: keyframe trim copies, exact writes it
YouTube's upload page lists 4:2:0 chroma and H.264. Sume video trim exact re-encodes to libx264 yuv420p; keyframe copies the stream and keeps the source format.
- How to assemble a long-form video with the Timeline 1.0 API
Timeline 1.0 renders one audio spine plus 1 to 200 ordered video slots into one MP4. Every URL must be Sume-hosted; the plan preflight is unbilled.
- How to burn captions onto a video with the Sume API
Send a public HTTPS video URL to POST /v1/video-captions and get a job-backed captioned video, timed by speech-to-text or by text you supply.
- How to extract frames from a video with the Sume API
POST /v1/video-frames returns stills at the times you name from one Sume-hosted clip, as durable images at source size. The call is unbilled.
Written by Sume