Subtitle guide Conversion guides

How to convert VTT to SSA


TL;DR — Convert browser WebVTT captions into an SSA or ASS-style editing file when a subtitle workflow needs SubStation Alpha structure.

Related tool

VTT to SSA Converter

Open VTT to SSA

WebVTT is a browser caption format. SSA is an older SubStation Alpha editing format that some legacy subtitle tools still require. If a project explicitly asks for .ssa, it helps to create a real SSA file instead of only an ASS-style substitute.

Quick answer

Use the VTT to SSA Converter to convert WebVTT captions into a real SubStation Alpha file. The output keeps cue timing and text, then creates the classic script, style, and dialogue sections expected by older SSA workflows.

Keep the original .vtt file if the final destination is still an HTML5 player. Use the converted file only when you need subtitle editing, styling, Aegisub review, or legacy SSA workflow compatibility.

When to convert VTT to SSA or ASS

Convert VTT to an SSA-style file when:

  • captions came from a web player or HTML5 video workflow
  • an editor asks for SSA, ASS, or SubStation Alpha subtitles
  • you need to add fonts, colors, positions, or typesetting later
  • WebVTT cue text needs to become editable dialogue events
  • a team expects [Script Info], style definitions, and Dialogue: rows

If the subtitles will stay on a website, keep WebVTT. Native browser caption tracks expect VTT, not SSA or ASS.

What changes during conversion

VTT stores a WEBVTT header, cue timestamps, optional cue settings, and text. SSA and ASS store dialogue rows with style metadata.

During conversion:

  • the WEBVTT header is removed
  • WebVTT timestamps are converted to SubStation Alpha timestamp format
  • cue text becomes Dialogue: event text
  • a [Script Info] section is added
  • a default style is created
  • browser-specific cue settings are not preserved exactly

The converter creates a style-ready base file. It does not invent a finished visual design.

Step-by-step workflow

  1. Start with a clean .vtt file.
  2. Open the VTT to SSA Converter.
  3. Upload or paste the WebVTT caption content.
  4. Convert the file to SSA output.
  5. Open the result in Aegisub or another SSA-family editor.
  6. Review any positioning or line break changes.
  7. Keep the original VTT file for browser delivery.

Before and after

VTT before

WEBVTT

00:00:01.000 --> 00:00:03.500 align:center
Welcome to the lesson.

00:00:04.000 --> 00:00:06.000
This VTT file needs an editing format.

SSA after

[Script Info]
Title: Converted subtitles
ScriptType: v4.00

[V4 Styles]
Format: Name, Fontname, Fontsize, PrimaryColour, SecondaryColour, TertiaryColour, BackColour, Bold, Italic, BorderStyle, Outline, Shadow, Alignment, MarginL, MarginR, MarginV, AlphaLevel, Encoding
Style: Default,Arial,20,16777215,65535,65535,0,0,0,1,2,2,2,10,10,10,0,1

[Events]
Format: Marked, Start, End, Style, Name, MarginL, MarginR, MarginV, Effect, Text
Dialogue: Marked=0,0:00:01.00,0:00:03.50,Default,,0,0,0,,Welcome to the lesson.
Dialogue: Marked=0,0:00:04.00,0:00:06.00,Default,,0,0,0,,This VTT file needs an editing format.

Common mistakes

Uploading SSA output back to an HTML5 player

Browsers use WebVTT for native <track> captions. Convert to SSA or ASS only when the next step is editing or a style-capable subtitle workflow.

Expecting VTT cue settings to map perfectly

WebVTT cue settings such as alignment and position are not the same as SSA or ASS style fields. Check the converted file in your subtitle editor before delivery.

Confusing SSA and ASS

SSA is older. ASS is newer and more common in modern tools. If an editor accepts ASS, prefer ASS unless a legacy system explicitly requires .ssa.

Converting a broken VTT source

If the WEBVTT header, timestamps, or blank lines are broken, repair the VTT before converting. A malformed source file can produce missing or incorrect dialogue events.

Frequently asked questions

How do I convert VTT to SSA?

Open the VTT to SSA Converter and convert the .vtt file into a real .ssa output when the workflow explicitly asks for SubStation Alpha.

Can I use ASS output if I searched for SSA?

Usually, yes. SSA is the older SubStation Alpha format. ASS is the newer Advanced SubStation Alpha format, and most current editors that support SSA-style workflows also support ASS.

Are WebVTT cue settings preserved in SSA?

Basic timing and text are preserved. Browser-specific cue settings may need manual review because VTT and SSA-family styling use different models.

Use the VTT to SSA Converter

Convert WebVTT captions into SSA format for legacy SubStation Alpha editing workflows and older subtitle tools. No signup, no upload, and everything runs locally in the browser.

Open VTT to SSA