How can we help?

Sidecar Subtitles vs. Embedded Subtitles Follow

The Zype platform supports two types of subtitles: Sidecar and Embedded. Below we outline some of the key differences regarding the two types.

Sidecar Subtitles 

This subtitle type refers to an uploaded external text file that is delivered to the player as a separate file from the video manifest.

You can upload subtitle files using the Subtitles tab on the edit page of any video. You can check our full article on how to upload and manage subtitles.

Note: Sidecar Subtitles are ONLY supported on Roku and Web players.

Embedded Subtitles

Unlike sidecar subtitles that are delivered separately from the video manifest, embedded subtitles are stitched into the video's HLS manifest. This type of subtitle is more widely supported across endpoint players.

Embedding a subtitle file is really simple. Below you can find a step by step guide on how to embed a subtitle into the video manifest using Zype's API:

Note: If you have the ability to host the subtitle files yourself, you can skip step 1. If you need the file to be hosted, you can follow step 1 to upload it to Zype before embedding it.

1. Upload the subtitle file on the Video Edit Options >> Subtitles tab and save it. Then, copy the link address URL which you will use in step 2.


2. Using a REST client or Zype's API tool, you will need to make the following call to the Subtitle Playlist endpoint

POST /videos/[REPLACE WITH video_id]/subtitle_playlists?api_key=[YOUR API KEY] HTTP/1.1
Content-Type: application/json
cache-control: no-cache

"subtitle_playlist": {

 3. Erase the subtitle file from the Video Edit Options on the Admin page


Article is closed for comments.