YouTube API now sets custom thumbnails on Shorts
What changed
YouTube's November 3, 2026 Data API revision says the thumbnails.set method now supports uploading custom thumbnails for YouTube Shorts after video processing is complete. The thumbnails resource gains a shortsAspectRatio property for Shorts custom thumbnails. The entry does not mention quota changes.
What it means
Scheduling tools can upload a custom thumbnail for a YouTube Short with thumbnails.set once the video has finished processing.
Who is affected
Tools and teams that publish YouTube Shorts through the API and want their own cover image.
What to do by 3 Nov 2026
Optional. Call thumbnails.set for a Short after processing completes, and read the new shortsAspectRatio property on the thumbnails resource.
What this means for you
A thumbnail is the small picture people see before they tap a video. Until now, apps could pick that picture for normal YouTube videos but not for Shorts. Now they can do it for Shorts too, once YouTube has finished getting the Short ready. So the tool you schedule with may soon let you choose a Short's cover image.
The details
- Method:
thumbnails.set"now supports uploading custom thumbnails for YouTube Shorts after video processing is complete." - Timing: call it after the Short has finished processing, not in the same step as the upload.
- Resource change: the
thumbnailsresource has a newshortsAspectRatioproperty for Shorts custom thumbnails. - File size:
thumbnails.setaccepts files up to 50MB since September 2026 (our entry). YouTube Help recommends 2160 x 3840 (9:16) for Shorts thumbnails; sizes are on the YouTube hub. - Not stated: any change to quota cost.
What to do next
- Business owners: Nothing.
- Marketers and agencies: Ask your scheduler whether it will add custom covers for YouTube Shorts.
- Developers: After a Short's processing finishes, call
thumbnails.setwith a 9:16 image, and read the newshortsAspectRatioproperty on the thumbnails resource.
Primary sources
- YouTube Data API: Revision history (November 3, 2026)
- YouTube Data API: thumbnails.set
- YouTube Data API: Thumbnails resource
Get an email when a new API change is added
Follow new entries with the RSS feed. Each platform also has its own feed, for example X or Meta.