> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livepeer.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Thumbnails (VOD)

> Get thumbnails for video assets from the playback info API (WebVTT and keyframe images).

For VOD assets, Livepeer Studio can provide **thumbnails** for use in scrubbing or previews. Thumbnails are generated during asset processing (typically one image per segment, about every 3 seconds).

<Info>
  Assets uploaded after November 21, 2023 have thumbnails generated by default. Older assets may need to be re-imported to get thumbnails.
</Info>

## Get playback info

1. [Upload an asset](upload-asset) and wait until it is ready (or use an existing asset).
2. Call the [Playback Info API](https://livepeer.studio/docs/api-reference/playback/get) with the asset's **playback ID**.

In the response, look in `meta.source` for an entry with `hrn: "Thumbnails"` and `type: "text/vtt"`. That URL points to a **WebVTT** file that lists keyframe image paths and time ranges.

## WebVTT format

The VTT file lists segments and corresponding image filenames, for example:

```vtt icon="terminal" theme={"theme":{"light":"github-light","dark":"dark-plus"}}
WEBVTT
00:00:00.000 --> 00:00:10.000
keyframes_0.jpg
00:00:10.000 --> 00:00:20.000
keyframes_1.jpg
```

## Build thumbnail URLs

If the VTT URL is:

`https://vod-cdn.lp-playback.studio/.../thumbnails/thumbnails.vtt`

then the first keyframe image is typically:

`https://vod-cdn.lp-playback.studio/.../thumbnails/keyframes_0.jpg`

Use the same base path as the VTT URL and append the filename from the VTT. You can pick the segment index that matches the time you want (e.g. For a scrubber or preview at 30 seconds, use the appropriate keyframe).

## Livestream thumbnails

For **livestreams**, the playback info returns a single **PNG** URL (`hrn: "Thumbnail (PNG)"`, `type: "image/png"`) that updates to the latest frame. See [Player and embed](../player) for poster/thumbnail usage in the Player.
