---
title: 'Video chapters'
description: 'Add chapters to videos and audio files so viewers can jump straight to the part they need in the player, also in shared and embedded players.'
url: https://www.medialab.co/support/core/review-and-approve/video-chapters
---

# Video chapters

Chapters divide a video or audio file into named parts, such as "Intro", "Interview" or "Q&A". Viewers can open the list of chapters in the player and jump straight to the part they need, and the progress bar is split into one segment per chapter.

### Adding chapters

1. Open the file.
2. In the sidebar, open the **Chapters** tab.
3. Enter a **Chapter name** and a **Timecode in** (`HH:MM:SS`, or `HH:MM:SS:FF` for frame-accurate timecodes on video). If you click in an empty timecode field, the current position of the player is filled in.
4. Click **Add chapter**.

A chapter runs until the next chapter starts, or until the end of the file, so you only enter where each chapter begins.

To change or remove a chapter, open the **⋮** menu next to it and choose **Edit** or **Delete**. Clicking a chapter in the list moves the player to that point. Added, changed and deleted chapters are recorded in the file's history.

### Watching with chapters

When a file has chapters, the player shows a **Chapters** button in its control bar. It opens a list of all chapters with their timecode and title; click one to jump to it.

Chapters are also shown when the file is watched through a share link or an embedded player, so external viewers can use them as well.

### Who can use chapters

- **Viewing**: everyone who can view the file can see and use its chapters in the player.
- **Adding, editing and deleting**: users with manage or file edit rights. Only these users see the **Chapters** tab in the sidebar.

Chapters are available for video and audio files, and require the Chapters add-on. Contact support if it is not enabled for your account.

### Using the API

Chapters can also be managed through the MediaLab API, for example to import chapters from another system:

- `GET /api/files/{file_id}/chapters` lists the chapters of a file.
- `POST /api/files/{file_id}/chapters` adds a chapter.
- `PUT` and `DELETE /api/files/{file_id}/chapters/{chapter_id}` change or remove a chapter.

See the [API methods](https://www.medialab.co/developers/methods) for full details.

### References

- [Viewing timecodes in video](https://www.medialab.co/support/core/review-and-approve/viewing-timecodes-in-video)
- [Comments and collaboration tools](https://www.medialab.co/support/onboarding/user-guide/comments-collaboration-tools)
- [Embedding a video on your website](https://www.medialab.co/support/core/sharing/embedding-a-video-on-your-website)
