Subtitles guide
How to name subtitle files so Plex, Jellyfin, Kodi and VLC find them
You downloaded an SRT file, dropped it next to the movie, and the subtitle menu still says "None". Or it shows up as "Unknown", or the forced subtitles for the alien dialogue never turn on. Nine times out of ten the cause is the file name, not the file.
This guide gives you one naming scheme that works across Plex, Jellyfin, Emby, Kodi, Infuse and VLC: the base rule, language codes, the forced, SDH and default flags, formats, Subs folders and the exact quirks of each player, checked against their official documentation. It ends with a troubleshooting checklist for encoding problems, wrong languages and subtitles that drift out of sync.
The base rule: same name as the video
Every player and media server matches an external subtitle to a video by its file name. The subtitle must start with the exact name of the video file, minus the extension, then optionally a language code and flags, then the subtitle extension.
Movies/
└── Dune (2021)/
├── Dune (2021).mkv
├── Dune (2021).en.srt
└── Dune (2021).fr.srtThe pattern is always: video name + .language + .flags + .extension. For a TV episode it is the same idea, with the full episode file name as the prefix:
TV Shows/
└── Breaking Bad/
└── Season 01/
├── Breaking Bad - S01E01 - Pilot.mkv
├── Breaking Bad - S01E01 - Pilot.en.srt
└── Breaking Bad - S01E01 - Pilot.es.srtThree details trip people up:
- Use dots as separators. Jellyfin only accepts a dot right after the video name, so
Dune (2021)-en.srtis ignored there even though Kodi and Infuse read it. Dots work everywhere. - Copy the whole video name, including the year and any tags. If the video is
Dune.2021.2160p.WEB-DL.mkv, a subtitle calledDune (2021).en.srtdoes not match. Rename one or the other so the prefixes are identical. - Show file extensions. Windows hides them by default, which is how people end up with
Dune (2021).en.srt.txtorDune (2021).mkv.en.srt. In File Explorer, turn on View > Show > File name extensions.
If you rename your videos, rename the subtitles in the same pass. A subtitle that kept the old release name is the most common reason subtitles disappear after a library cleanup.
Language codes: ISO 639-1 and ISO 639-2
The language goes right after the video name. Plex documents two standards and every other player on this page accepts them too: ISO 639-1 (two letters) and ISO 639-2/B (three letters). Both are fine; pick one and stay consistent.
| Language | ISO 639-1 | ISO 639-2/B | Example file |
|---|---|---|---|
| English | en | eng | Dune (2021).en.srt |
| French | fr | fre | Dune (2021).fre.srt |
| Spanish | es | spa | Dune (2021).es.srt |
| German | de | ger | Dune (2021).de.srt |
| Portuguese | pt | por | Dune (2021).pt.srt |
| Italian | it | ita | Dune (2021).it.srt |
| Dutch | nl | dut | Dune (2021).nl.srt |
| Polish | pl | pol | Dune (2021).pl.srt |
| Japanese | ja | jpn | Dune (2021).ja.srt |
| Chinese | zh | chi | Dune (2021).zh.srt |
A few languages have two three-letter codes: a bibliographic "B" code and a terminology "T" code (fre/fra, ger/deu, dut/nld, chi/zho). Plex names the B list, so if you use three letters, the B code is the safe choice. The two-letter codes avoid the question entirely.
Regional variants
Support for regions such as Brazilian Portuguese or Traditional Chinese is less uniform. Emby documents codes like zh-CN and zh-TW, Jellyfin's own example uses en_us, and Kodi 22 accepts BCP 47 tags with the dash replaced by an underscore (zh_yue). Plex's article only documents the two- and three-letter codes. If you need two variants of one language, test with your own server before renaming a whole library.
Language names instead of codes
Kodi also accepts the English name of a language (Dune (2021).English.srt), and Emby's examples include spanish. Plex does not document names, which is why a file like that often shows up as "Unknown" in Plex. Codes are the portable option.
Forced, SDH, CC and default flags
Flags go after the language code, separated by dots. They tell the server what kind of subtitle the file is, so it can pick the right one automatically.
Forced subtitles
Forced subtitles only cover lines in another language, signs or on-screen text: the Chakobsa dialogue in Dune, the Spanish phone calls in Breaking Bad. They are meant to appear even when you have subtitles turned off. Add forced:
Dune (2021).en.forced.srt
Breaking Bad - S01E01 - Pilot.en.forced.srtJellyfin and Emby also accept foreign as a synonym. Kodi reads forced in any letter case and has done so since version 13.
SDH, CC and hearing impaired
Subtitles for the deaf and hard of hearing add sound cues like [phone rings] and speaker names. Mark them so they can be told apart from regular subtitles:
Dune (2021).en.sdh.srt
Dune (2021).en.cc.srtPlex reads sdh and cc (it needs Plex Media Server 1.20.3.3401 or newer and the current Plex Movie agent, not the legacy one). Jellyfin 10.9 and later reads sdh, cc and hi. Emby documents sdh.
In Jellyfin, hi on its own means Hindi. Dune (2021).hi.srt is a Hindi subtitle; Dune (2021).en.hi.srt is English hearing impaired. Use sdh to avoid the ambiguity.
Default
The default flag asks the server to select this track automatically. Jellyfin, Emby and Kodi read it; Plex does not document it and relies on your account's subtitle settings instead.
Dune (2021).en.default.srtWhich flag works where
| Flag | Plex | Jellyfin | Emby | Kodi 21 | Infuse | VLC |
|---|---|---|---|---|---|---|
| forced | Yes | Yes (also foreign) | Yes (also foreign) | Yes | Not documented | No |
| sdh | Yes | Yes | Yes | Kept as track name | Not documented | No |
| cc | Yes | Yes | Not documented | Kept as track name | Not documented | No |
| hi | No | Yes, with a language | Not documented | Kept as track name | Not documented | No |
| default | Not documented | Yes | Yes | Yes | Not documented | No |
Kodi 21 only reads forced and default as flags. Any other word, such as sdh, ends up in the name shown in the subtitle menu, which still lets you choose the right file by hand. VLC ignores flags entirely: it simply lists every matching file.
Several subtitles in the same language
You can keep a regular, a forced and an SDH subtitle side by side, as long as each name is different:
Movies/
└── Dune (2021)/
├── Dune (2021).mkv
├── Dune (2021).en.srt
├── Dune (2021).en.forced.srt
├── Dune (2021).en.sdh.srt
├── Dune (2021).fr.srt
└── Dune (2021).fr.forced.srtWhat you cannot do in every player is keep two plain English files, such as a cinema translation and a commentary track. Each server handles extra words differently:
- Jellyfin: any text that is not a language or a flag becomes the track title.
Dune (2021).Commentary.en.srtshows as an English track titled Commentary. - Emby: put a label in parentheses, as in its documentation:
Dune (2021).English(Commentary).srt. - Kodi: leftover words become part of the track name, so
Dune (2021).en.Commentary.srtworks. - Plex: only the language and the documented flags are understood. A Plex staff member has explained that a file with tags it does not recognize can be silently ignored, and when two files share a language and flags, Plex has no way to tell them apart. Keep one file per language and flag combination for Plex.
Subtitle formats: SRT, ASS, VTT, SUB/IDX and SUP
The extension matters as much as the name. Text formats are small, easy to edit and work almost everywhere. Image formats are pictures of text taken from DVDs and Blu-rays.
| Format | Extension | Type | Good to know |
|---|---|---|---|
| SubRip | .srt | Text | The universal choice. Supported by every player here, and what OpenSubtitles mostly serves. |
| SubStation Alpha | .ass / .ssa | Text with styling | Fonts, colors and positions, common for anime. Plex lists it as fully supported, but styling is not rendered identically on every client. |
| WebVTT | .vtt | Text | The web standard. Supported by Plex, Jellyfin, Emby and Kodi 20 and later. |
| VobSub | .sub + .idx | Image (DVD) | Two files that must share the same base name, both next to the video: Dune (2021).en.idx and Dune (2021).en.sub. |
| PGS | .sup | Image (Blu-ray) | Jellyfin and Kodi read external .sup files. On many Plex apps, image subtitles force a transcode to burn them into the picture. |
| SAMI | .smi | Text | Older format, still in Plex's fully supported list. |
Plex states that SRT, SMI, SSA/ASS and VTT are fully supported on all apps, while VobSub and PGS may require the video to be transcoded so the subtitles can be burned in. Infuse notes that AirPlay and Google Cast only handle text subtitles. If you stream to TVs or phones, SRT saves you a lot of server load.
Need to turn a .sup or .sub/.idx into SRT? Free tools such as Subtitle Edit can run OCR on image subtitles. Check the result: OCR confuses l, I and 1 more often than you would expect.
Subtitles in a Subs folder
Many releases ship with a Subs folder. Whether your player looks inside it depends on the software, and the files inside still need the right names.
| Player | Reads a subfolder? | Folder names |
|---|---|---|
| Plex | Yes, server 1.41.0 or newer with the Plex Movie or Plex Series agent | Subs or Subtitles, in the same folder as the video |
| Jellyfin | No, only the video's folder | Not applicable |
| Emby | Not documented | Keep files next to the video |
| Kodi | Yes | subs, subtitles, sub, subtitle, vobsub, vobsubs, plus a custom folder you can set |
| Infuse | Not documented | Firecore says to keep the file in the same folder |
| VLC | Yes | subs and subtitles by default, editable in the advanced preferences |
For a season, Plex expects the Subs folder inside the season folder, next to the episodes:
TV Shows/
└── Breaking Bad/
└── Season 01/
├── Breaking Bad - S01E01 - Pilot.mkv
├── Breaking Bad - S01E02 - Cat's in the Bag....mkv
└── Subs/
├── Breaking Bad - S01E01 - Pilot.en.srt
└── Breaking Bad - S01E02 - Cat's in the Bag....en.srtSome release groups put files like Subs/2_English.srt or Subs/Dune.2021.1080p/3_French.srt in the folder. None of the players on this page can match those names to the video. Move them next to the video and rename them to the video's name plus a language code.
Since Jellyfin ignores subfolders and Emby and Infuse only document files next to the video, the layout that works everywhere is the simplest one: subtitles in the same folder as the video.
How each player finds subtitles
Plex
Plex's pattern is Movie_Name (Release Date).[Language_Code].ext for movies and Show_Name SxxEyy.[Language_Code].ext for episodes, with forced, sdh or cc added before the extension. The current Plex Movie and Plex TV Series agents always look for local subtitles. With a legacy agent, open Settings, select your server, go to Agents and make sure Local Media Assets is checked.
Plex does not notice a new subtitle until the item is refreshed: open the movie or episode, click the three-dot menu and choose Refresh Metadata. Which subtitle starts automatically depends on your account's language settings (subtitle mode such as "Shown with foreign audio" or "Always enabled"). More folder rules are in our Plex naming guide.
Jellyfin
Jellyfin reads files in the video's folder whose name starts with the video name followed by a dot. Each extra field is either a language, a flag (default, forced/foreign, sdh/cc/hi) or free text used as the track title. It accepts .srt, .ass, .ssa, .vtt, .sub, .sup, .smi and more. After adding files, use the item's menu, Refresh metadata, then Scan for new and updated files. Automatic selection follows the user's subtitle mode (Default, Smart, Only forced, Always, None) in the playback settings. See the Jellyfin naming guide for the movie and show folders.
Emby
Emby's rule is "same file name as the movie, except for the extension": Home Alone (1990).spa.srt, with .default, .forced (or .foreign) and .sdh inserted before the extension. It documents ass, srt, ssa, sub/idx and vtt. Refresh the item's metadata after adding files.
Kodi
Kodi looks for external subtitles when playback starts, so no library scan is needed. It checks the video's folder, the common subfolders listed above and an optional custom folder (Settings > Player > Subtitles > Subtitle storage location set to Custom location, then Custom subtitle folder). The language can be a code or an English name, and Kodi accepts dots, spaces or dashes as separators: Dune (2021).en.forced.srt and Dune (2021)-English-Forced.srt both work. Folder rules for the library itself are in the Kodi naming guide.
Infuse
Firecore's documentation says to name the subtitle so it matches the video and keep it in the same folder, with a language suffix for each extra language (its example: Inception-2010-en.srt). The dot style used by Plex and Jellyfin is the better choice if the same files are also served by Jellyfin. Local subtitles are not supported over UPnP or DLNA connections, and when Infuse browses a Plex, Jellyfin or Emby server it gets subtitles from that server, so the server's naming rules are the ones that count.
VLC
VLC is the most forgiving. Its Autodetect subtitle files option is on by default (Tools > Preferences > Show settings: All > Video > Subtitles / OSD): it loads subtitles whose name starts with the video name, with extra text allowed after it, and it also looks in the subs and subtitles folders. It ignores flags and simply lists every match, so VLC is a good quick test: if VLC does not see your file either, the name or the location is wrong. You can always load one manually with Subtitle > Add Subtitle File.
Troubleshooting: not showing, wrong language, garbled or out of sync
Subtitles not showing in Plex, Jellyfin or Kodi
- Compare the names character by character. The subtitle must start with the exact video name, including the year, spaces, brackets and release tags.
- Check the real extension with extensions visible.
.srt.txtis not a subtitle. - Make sure the file is in the same folder as the video (or a Subs folder for Plex 1.41+, Kodi and VLC only).
- Remove words the server does not know. For Plex, keep only the language and
forced,sdhorcc. - Refresh the item (Plex: Refresh Metadata; Jellyfin and Emby: Refresh metadata with a scan for new files). Kodi and VLC read subtitles at playback.
- Check that the subtitle mode in your account is not set to manual only or off.
Wrong language or "Unknown"
"Unknown" almost always means the server did not find a code it understands: a language name instead of a code in Plex, a typo such as .eng1.srt, or a code placed after free text. Use two- or three-letter ISO codes right after the video name. In Jellyfin, remember that hi alone is Hindi. If a server labels the file correctly but shows the wrong text, the subtitle itself is in another language: download a new one.
Strange characters (é, ’, boxes)
This is an encoding problem, typical of older subtitles saved as Windows-1252 or another legacy code page. Plex recommends saving text subtitles as UTF-8. To convert, open the .srt in a text editor (Notepad on Windows, TextEdit on Mac, VS Code or Subtitle Edit anywhere), choose Save As and pick UTF-8 as the encoding. In Kodi you can also change Settings > Player > Subtitles > Character set, and in VLC the Default encoding under Subtitles / OSD, but converting the file fixes it for every player at once.
Out-of-sync subtitles
- Constant offset (always two seconds early): the subtitle was made for a release with a different intro or studio logo. Shift all timings. VLC's G and H keys move subtitles in 50 ms steps, Kodi has a subtitle offset in the playback menu, and Subtitle Edit can save the shift permanently.
- Gradual drift (fine at the start, ten seconds off at the end): a frame rate mismatch, usually 23.976 vs 25 fps. Use Subtitle Edit's frame rate conversion instead of an offset.
- Out of sync after a scene: the subtitle comes from a different cut (theatrical vs extended). No offset will fix it; get a subtitle for your exact version.
The quickest fix for sync problems is usually a better match. Subtitles uploaded for the same release (same source, group and runtime) as your video are far more likely to line up.
Getting correctly named subtitles with RenameFlow
Naming subtitles by hand is fine for one movie. For a whole season it gets tedious, and one wrong character means a missing track.
RenameFlow is a web app that runs in Chrome, Edge or Opera on a desktop computer. Its Subtitles module searches OpenSubtitles for your videos and saves the subtitle you pick next to the video, named after it with a language code (for example Dune (2021).fr.srt), which is the layout every player on this page reads. On the free plan you get 3 subtitle downloads a month; paid plans are unlimited. The step by step is in our guide to downloading subtitles.
It helps to clean up video names first. RenameFlow renames the video files themselves in place on your disk (nothing is uploaded) with Plex, Jellyfin, Kodi or Simple presets, so the subtitles you download afterwards match the final names. Note that RenameFlow renames files only: it does not create or move folders, so you still create the Dune (2021) or Season 01 folders yourself. Forced and SDH flags are also yours to add if you need them.
Get subtitles that are already named right
Rename your videos with Plex, Jellyfin or Kodi presets, then download subtitles from OpenSubtitles that land next to each video with the matching name. Free to start, nothing to install.
Try RenameFlow free