Video Subtitle Embed

Embed subtitle files as soft subtitles in videos (switchable subtitle tracks, not burned into video)

Click to upload file or drag and drop file here

Maximum file size: 100MB Supported formats: video/*

Click to upload file or drag and drop file here

Maximum file size: 5MB Supported formats: .srt, .ass, .ssa, .vtt, text/plain, text/x-vtt

Preserve existing subtitle tracks in the video

ISO 639-2/B language code for the embedded subtitle

Key Facts

Category
Images, Audio & Video
Input Types
file, checkbox, text, select
Output Type
file
Sample Coverage
4
API Ready
Yes

Overview

The Video Subtitle Embed tool allows you to seamlessly integrate external subtitle files—such as SRT, ASS, SSA, or VTT—directly into your video files as soft, switchable subtitle tracks. Unlike hardcoding or burning subtitles into the video frame, this tool preserves the original video quality and gives viewers the flexibility to toggle subtitle tracks on or off, select languages, and keep existing subtitle tracks intact across formats like MKV, MP4, WebM, AVI, and MOV.

When to Use

  • When you want to add multiple language subtitle tracks to a video without permanently burning them into the video image.
  • When you need to package SRT, ASS, SSA, or VTT subtitle files directly into a single video container for easier sharing and playback.
  • When you want to preserve existing subtitle tracks in a video while adding a new, switchable translation track.

How It Works

  • Upload your source video file and select the corresponding subtitle file in SRT, ASS, SSA, or VTT format.
  • Configure your preferences, such as setting the ISO 639-2/B language code, choosing whether to keep original subtitle tracks, and selecting your preferred output container format.
  • Process the files to merge the subtitle track into the video container as a soft, switchable stream without re-encoding the video.

Use Cases

Adding localized subtitle tracks (e.g., English, Spanish, French) to a movie file for multi-language distribution.
Packaging timed captions (VTT or SRT) into lecture or training videos for accessibility compliance.
Consolidating raw ASS styling subtitles into anime or fan-subbed videos while retaining advanced typesetting.

Examples

1. Adding Multi-Language Support to an Indie Film

Independent Filmmaker
Background
An indie filmmaker has finished editing a feature film and has received professional Spanish subtitles in SRT format.
Problem
They need to distribute the film as a single file containing both the original audio and the Spanish subtitle track, without permanently burning the text onto the video.
How to Use
Upload the MP4 film file and the Spanish SRT subtitle file. Set the Subtitle Language Code to 'spa', check 'Keep Original Subtitles', select 'MKV' as the output format, and run the tool.
Example Config
videoFile: 'indie_film.mp4', subtitleFile: 'spanish_subs.srt', keepOriginalSubtitles: true, subtitleLanguage: 'spa', outputFormat: 'mkv'
Outcome
An MKV video file is generated containing the original video and audio, plus a switchable Spanish subtitle track that viewers can toggle on or off.

2. Embedding Captions for Online Lectures

E-Learning Content Creator
Background
An instructor has recorded a series of educational videos and generated VTT caption files for accessibility.
Problem
Students need to be able to turn captions on or off depending on their learning preferences, and the instructor wants to avoid managing separate video and subtitle files.
How to Use
Upload the lecture video and the VTT caption file. Set the language code to 'eng', choose 'MP4' as the output format, and process the file.
Example Config
videoFile: 'lecture_01.mp4', subtitleFile: 'lecture_01.vtt', keepOriginalSubtitles: false, subtitleLanguage: 'eng', outputFormat: 'mp4'
Outcome
An MP4 video file with an embedded, switchable English subtitle track, fully compatible with standard media players.

Try with Samples

video, text, file

Related Hubs

FAQ

What is the difference between soft subtitles and burned-in subtitles?

Soft subtitles are embedded as a separate, switchable text track inside the video file, allowing viewers to turn them on or off. Burned-in (hard) subtitles are permanently merged into the video frames and cannot be disabled.

Which subtitle formats does this tool support?

The tool supports SRT, ASS, SSA, and VTT subtitle formats.

Will embedding soft subtitles degrade my video quality?

No, embedding soft subtitles does not re-encode the video stream, meaning your original video quality remains completely untouched.

Can I keep the existing subtitle tracks already present in my video?

Yes, by enabling the 'Keep Original Subtitles' option, the tool will preserve all pre-existing subtitle tracks alongside the new one.

What output formats can I choose for my video?

You can export your video in MKV, MP4, WebM, AVI, or MOV formats, with MKV being highly recommended for optimal subtitle compatibility.

API Documentation

Request Endpoint

POST /en/api/tools/video-subtitle-embed

Request Parameters

Parameter Name Type Required Description
videoFile file (Upload required) Yes -
subtitleFile file (Upload required) Yes -
keepOriginalSubtitles checkbox No Preserve existing subtitle tracks in the video
subtitleLanguage text No ISO 639-2/B language code for the embedded subtitle
outputFormat select No -

File type parameters need to be uploaded first via POST /upload/video-subtitle-embed to get filePath, then pass filePath to the corresponding file field.

Response Format

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
File: File

AI MCP Documentation

Add this tool to your MCP server configuration:

{
  "mcpServers": {
    "elysiatools-video-subtitle-embed": {
      "name": "video-subtitle-embed",
      "description": "Embed subtitle files as soft subtitles in videos (switchable subtitle tracks, not burned into video)",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=video-subtitle-embed",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

You can chain multiple tools, e.g.: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, max 20 tools.

Supports URL file links or Base64 encoding for file parameters.

If you encounter any issues, please contact us at [email protected]