Documentation Index

Fetch the complete documentation index at: https://cloudinary.com/documentation/llms.txt

Use this file to discover all available pages before exploring further.

Image & Video APIs

How do I get a thumbnail image from a specific moment in a video?

Last updated: Nov-09-2026

Quick answer
To get a thumbnail or poster image from a specific moment in a video, change the file extension of the video's public ID to an image format such as .jpg, and add a start offset (so_) in seconds:

so_8.0/van-driving-mountain-road.jpg

The offset only affects the image. It doesn't change the video, which still plays from the beginning.

The question

"How do I change the video thumbnail to a specific part of the video, without making the video start from that point?"

A poster is the still image that shows before a video plays, and in lists and previews. By default, Cloudinary uses the middle frame of the video. Often that isn't the best frame, so you may want to choose another one.

The original asset

The examples use this 10.9-second video:

The solution

  1. Request the video as an image. Use an image extension (.jpg, .png, .webp, or .avif) in place of the video extension, to deliver a single frame as an image.
  2. Choose the frame. Add the start offset (so_) as the number of seconds from the start of the video, or as a percentage of the video's length (such as so_50p).

This example takes the frame at 8 seconds:

Frame at 8 seconds of the video, delivered as a JPG


Without an offset, the thumbnail is the frame from the middle of the video. For the first frame, use so_0. These are the frames at 2 seconds and at 50% of the video:

Frame at 2 seconds of the video


Frame at 50 percent of the video


Let Cloudinary choose the frame

To have Cloudinary pick a suitable frame automatically, use so_auto:

Frame automatically chosen from the video


Resize the poster to fit your page

Add a resize in a separate component, so that the poster is the size you need. This example creates a 700x400 poster from the frame at 8 seconds:

Frame at 8 seconds, cropped to 700x400


Use the image as the poster of an HTML video

Set the image URL as the poster attribute of your video tag, so it shows before the video plays:

Note
The so_ offset in the poster URL doesn't change the video URL. Don't add it to the video's src, or the video itself starts from that point.

Related topics

✔️ Feedback sent!

Rate this page:

one star two stars three stars four stars five stars