Add chapter markers

Learn how to create a WebVTT file for video captions and chapters.

A chapter marker provides a way to convey viewing milestones within the timeline of a player. It allows the segmentation of long videos into discrete segments.


Chapter marker in a video

A viewer can quickly hover over the cue point and can see the title of the chapter or section. Clicking on the cue point navigates you directly to that point of the video. These markers are rendered by the player when a standard WebVTT text track is provided in the player embed code.

JWP provides the following approaches to adding chapter markers to the videos in your media library.

Tracks EditorEnables creating chapters from your JWP dashboard
.VTT file uploadEnables manually creating and uploading a Web Video Text Track file that defines each chapter in a video

Tracks Editor


This is a beta offering. By using this documentation, you are agreeing to abide by the terms of the JWP Beta Program Agreement.

Track editor for chapter markers

Track editor for chapter markers

The Tracks Editor enables you to define chapter markers for a media item directly within your JWP dashboard.

Follow these steps to create chapter markers:

  1. From your Media Library, click the name of a video. The media details page appears.
  2. On the right side of the page beneath the preview player, click the Tracks tab.
  3. In the Chapters section, click Manage. The Chapters tracks panel appears.
  4. Click Create. The track creation page appears.
  5. Enter the name of the caption track.
  6. Click Set Language Code. The Language Code popup appears.
  7. Enter the language code for the captions.


    By right-clicking View List of Codes > Open Link in a New Tab, a list of all the acceptable language code values will appear in a new tab.

  8. In the timecode field, set the time for the chapter marker in HH:MM:SS.mmm format. This is the point at which the chapter begins.
  9. In the text box, enter the text for the chapter.
  10. Click Save.


    Click ▶ in the preview player to preview the chapter marker.

  11. (Optional) Click + to add another chapter. The timecode field and text box appear.
  12. (Optional) Repeat steps 8-11 to add another caption.

Returning to the Chapter Tracks tab, the list of chapters is displayed.

.VTT file upload

If your content is uploaded or registered with the JWP dashboard, you can also host your VTT file on the JWP platform.


A .vtt file is subject to cross-domain security restrictions and therefore will not automatically load from another domain than the player.

Use the following steps to upload chapter markers:

  1. Create a .vtt file for your chapter markers.
  2. From your Media Library, click the name of the video to which to add chapter markers. The video details page appears.
  3. On right side of the page beneath the preview player, click the Tracks tab.
  4. In the Chapters section, click Manage. The Chapters Tracks panel appears.
  5. Click Upload.
  6. Select a single .vtt file or multiple .vtt files to open from your computer. The selected file or files are uploaded and associated with the video. Once uploaded, the track appears on the Chapters Tracks panel.