API Reference
Wistia Learning CenterWistia

Update Thumbnail Customizations

put
https://api.wistia.com/modern/medias//customizations/thumbnail

Applies a partial update to a video's thumbnail customizations. Only the
fields supplied are changed; sending a field as null deletes it (reverting to
the default).

Requires api token with one of the following permissions

Read, update & delete anything
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requestsā€¦
LoadingLoadingā€¦
Path Params
string
required

The hashed ID of the video to be customized.

Body Params

Pre-play poster image and looping video thumbnail / text-overlay plugins for
a video. Every field is optional; only the fields you send are changed
(partial update). Send a field as null to reset it to its default.

string

Overrides the thumbnail image that appears before the video plays.

string

Alt text for the thumbnail image, used for accessibility.

string

Resizes the thumbnail when there's a discrepancy between its aspect ratio and that of its parent container. Options are contain, cover, fill, and none.

string

Reference to the original, unaltered still image asset.

plugin
object

Container for thumbnail-related player plugin configurations.

Headers
string
required
Defaults to 2026-07
Responses

Updated 29 days ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoadingā€¦
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 29 days ago

Did this page help you?