Published on November 19, 2026

Mux Robots-generated thumbnails and chapters, straight to your player

Matthew Rehrer
By Matthew Rehrer • 4 min read • Product

Mux Robots generates context for your content: the frames that make the best thumbnails, the logical sections that become chapters, and more. Until now, most of that context stopped at the job output. Getting it back onto your video and in front of your viewers was up to you.

Thinking across products, we found some great opportunities to close that loop with a round trip. Robots runs an AI workflow on your video, writes the results back to the Mux Video asset, and viewers see them in players like Video.js v10 without any additional development. Captions already worked this way, and now more workflows do too. Find best thumbnails sets an asset’s default thumbnail, and Generate chapters and Analyze structure add chapters to the asset.

These workflows build on new Mux Video functionality, so you can also set default thumbnails through the API or dashboard, and add chapters through the API, with or without Robots.

LinkThumbnails help viewers discover their next destination

Thumbnails are often the visual front door to help grab the attention of viewers. Picking a dynamic and representative default helps inform and engage the audience. Previously, Mux Video would automatically use a frame at the midpoint as a default thumbnail. This was the thumbnail returned by the image API when no time parameter was supplied and nothing guarantees that this is an ideal thumbnail. You can also specify a time value with the image API to retrieve a specific thumbnail.

The Mux Robots Find best thumbnails workflow samples frames throughout your video to nominate thumbnails by using a vision model that weights focus, faces, action, composition, color, contrast, and steering that you get to control. The model combines all these qualities to automatically select a thumbnail that is visually interesting and appropriately representative.

Mux dashboard panel for creating a Mux Robots Find best thumbnails job on a video asset, with the “Update asset thumbnail” toggle turned on so the selected frame becomes the asset’s default thumbnail.

Set update_asset_thumbnail to true via the Robots API or dashboard and it will populate the asset's thumbnail_timein Mux Video. You'll see these updates reflected on the asset details page in the Mux dashboard.

You can also set the thumbnail_time parameter for an asset directly with the video API or interactively within the dashboard without running a Mux Robots job.

Set default thumbnail via API
curl https://api.mux.com/video/v1/assets/${ASSET_ID} \ -H "Content-Type: application/json" \ -X PATCH \ -d '{ "thumbnail_time": 12.67 }' \ -u ${MUX_TOKEN_ID}:${MUX_TOKEN_SECRET}
Mux dashboard “Create default thumbnail” section on a video asset, showing a preview frame of a concert with stage lights at 0:13, a timeline slider for picking a frame, and a “Thumbnail time” field set to 0:13.

LinkChapters mark the journey

Chapters not only improve visibility into the content, proportions, and sequence in videos but they also make longer-form content more consumable and make it easy for viewers to navigate to just the right moment.

Mux dashboard panel for creating a Mux Robots Generate chapters job on a video asset, with the “Update asset chapters” toggle turned on so generated chapters are added to the asset.

Mux Video now supports directly associating chapter metadata with your assets. The chapters are stored with the asset in the standard HLS JSON format.

You can use Mux Robots the Generate chapters or Analyze structure workflows to find logical sections in your content to divide videos into easily explored and navigable chapters. They can update an asset when update_asset_chapters is set to true and adds this chapter information as a track that is accessible in the HLS JSON format.

Example chapters JSON
[ { "chapter":1, "start-time":0, "titles":[{"language":"en","title":"Instrumental Opening"}] }, { "chapter":2, "start-time":27, "titles":[{"language":"en","title":"Opening Travel Montage"}] }, { "chapter":3, "start-time":119, "titles":[{"language":"en","title":"Skiing in Niseko"}] }, { "chapter":4, "start-time":435, "titles":[{"language":"en","title":"Tourism in Tokyo"}] }, { "chapter":5, "start-time":518, "titles":[{"language":"en","title":"Conclusion"}] } ]

As with thumbnails, you can also add chapters directly with the API by providing this HLS formatted JSON.

Add chapters via API
curl https://api.mux.com/video/v1/assets/${ASSET_ID}/tracks \ -X POST \ -d '{ "url": "https://example.com/my-video-chapters.json", "type": "text", "text_type": "chapters", "language_code": "en", "name": "English" }' \ -H "Content-Type: application/json" \ -u ${MUX_TOKEN_ID}:${MUX_TOKEN_SECRET}

One important note, an asset holds a single chapters track, so if you were to run a Robots job to generate and loop chapters back into Mux Video, any chapters track already on the asset will be deleted and replaced.

HLS players like Video.js support JSON chapters without any additional development. The Video.js v10 player timeline visually shows how the content is divided into segments of varying lengths. The storyboard images that display when you mouse over the segmented timeline have the chapter title text overlaid on them along with the timestamp for that storyboard image preview.

Video.js v10 player with a timeline divided into chapter segments. Hovering over the timeline shows a storyboard preview with the chapter title and timestamp.

LinkDirectives can put these round trips on autopilot

These workflows help make content discoverable and digestible so creators and audiences find each other. Once you have a set of workflows you are happy with for new assets you can utilize Mux Robots Directives to generate prerequisite resources automate and run multiple workflows on asset upload, so that all new assets get thumbnails and chapters automatically.

Mux dashboard Create Directive panel named “Thumbnails & Chapters on Ingest,” bundling the Find Best Thumbnails and Generate Chapters workflows with their resource dependencies: a shot list, recommended for Find Best Thumbnails, and a caption track, required by Generate Chapters.

LinkBook your round trip

These round trips are available now. Try the Find best thumbnails, Generate chapters, and Analyze structure workflows on an asset in the dashboard, then see the results in Video.js v10. Once you’re happy with the output, set up Directives to run them on every new asset.

Written By

Leave your wallet where it is

No credit card required to get started.