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.

    Updated November 22, 202612 min read

    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.

    One movie, two subtitle languages
    Movies/
    └── Dune (2021)/
        ├── Dune (2021).mkv
        ├── Dune (2021).en.srt
        └── Dune (2021).fr.srt

    The 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 episode subtitles
    TV Shows/
    └── Breaking Bad/
        └── Season 01/
            ├── Breaking Bad - S01E01 - Pilot.mkv
            ├── Breaking Bad - S01E01 - Pilot.en.srt
            └── Breaking Bad - S01E01 - Pilot.es.srt

    Three details trip people up:

    • Use dots as separators. Jellyfin only accepts a dot right after the video name, so Dune (2021)-en.srt is 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 called Dune (2021).en.srt does 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.txt or Dune (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.

    LanguageISO 639-1ISO 639-2/BExample file
    EnglishenengDune (2021).en.srt
    FrenchfrfreDune (2021).fre.srt
    SpanishesspaDune (2021).es.srt
    GermandegerDune (2021).de.srt
    PortugueseptporDune (2021).pt.srt
    ItalianititaDune (2021).it.srt
    DutchnldutDune (2021).nl.srt
    PolishplpolDune (2021).pl.srt
    JapanesejajpnDune (2021).ja.srt
    ChinesezhchiDune (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.srt

    Jellyfin 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.srt

    Plex 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.srt

    Which flag works where

    FlagPlexJellyfinEmbyKodi 21InfuseVLC
    forcedYesYes (also foreign)Yes (also foreign)YesNot documentedNo
    sdhYesYesYesKept as track nameNot documentedNo
    ccYesYesNot documentedKept as track nameNot documentedNo
    hiNoYes, with a languageNot documentedKept as track nameNot documentedNo
    defaultNot documentedYesYesYesNot documentedNo

    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:

    A complete subtitle set
    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.srt

    What 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.srt shows 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.srt works.
    • 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.

    FormatExtensionTypeGood to know
    SubRip.srtTextThe universal choice. Supported by every player here, and what OpenSubtitles mostly serves.
    SubStation Alpha.ass / .ssaText with stylingFonts, colors and positions, common for anime. Plex lists it as fully supported, but styling is not rendered identically on every client.
    WebVTT.vttTextThe web standard. Supported by Plex, Jellyfin, Emby and Kodi 20 and later.
    VobSub.sub + .idxImage (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.supImage (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.smiTextOlder 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.

    PlayerReads a subfolder?Folder names
    PlexYes, server 1.41.0 or newer with the Plex Movie or Plex Series agentSubs or Subtitles, in the same folder as the video
    JellyfinNo, only the video's folderNot applicable
    EmbyNot documentedKeep files next to the video
    KodiYessubs, subtitles, sub, subtitle, vobsub, vobsubs, plus a custom folder you can set
    InfuseNot documentedFirecore says to keep the file in the same folder
    VLCYessubs 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:

    Plex 1.41+ Subs folder layout
    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.srt

    Some 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

    1. Compare the names character by character. The subtitle must start with the exact video name, including the year, spaces, brackets and release tags.
    2. Check the real extension with extensions visible. .srt.txt is not a subtitle.
    3. Make sure the file is in the same folder as the video (or a Subs folder for Plex 1.41+, Kodi and VLC only).
    4. Remove words the server does not know. For Plex, keep only the language and forced, sdh or cc.
    5. Refresh the item (Plex: Refresh Metadata; Jellyfin and Emby: Refresh metadata with a scan for new files). Kodi and VLC read subtitles at playback.
    6. 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

    Frequently asked questions

    What is the correct subtitle file naming convention?
    Use the exact video file name, then a language code, then any flags, then the extension: Dune (2021).en.srt, Dune (2021).en.forced.srt or Dune (2021).en.sdh.srt. Separate the parts with dots and keep the subtitle in the same folder as the video. This format works in Plex, Jellyfin, Emby, Kodi, Infuse and VLC.
    Should I use en or eng in an SRT file name?
    Both work. Plex documents ISO 639-1 two-letter codes (en) and ISO 639-2/B three-letter codes (eng), and Jellyfin, Emby and Kodi accept them too. If you use three letters, prefer the B codes such as fre and ger for Plex. Whatever you choose, stay consistent across the library.
    Why are my subtitles not showing in Plex?
    The usual causes are a name that does not exactly match the video, a hidden .txt extension, an unrecognized word in the name, or a subtitle that Plex has not scanned yet. Fix the name, then use Refresh Metadata on the item. With a legacy agent, also make sure Local Media Assets is enabled under Settings > Agents.
    How do I name forced subtitles?
    Add forced after the language code: Dune (2021).en.forced.srt. Plex, Jellyfin, Emby and Kodi all recognize it, and Jellyfin and Emby also accept foreign. Forced subtitles are meant for foreign-language lines and signs, and can turn on even when regular subtitles are off.
    How do I name SDH or hearing impaired subtitles?
    Add sdh after the language code: Dune (2021).en.sdh.srt. Plex also accepts cc, and Jellyfin accepts sdh, cc or hi. Avoid hi on its own in Jellyfin, because it is read as Hindi.
    Why are Kodi subtitles not showing?
    Kodi needs the subtitle name to start with the video name and the file to be in the video's folder, a common subfolder such as Subs, or the custom subtitle folder set under Settings > Player > Subtitles. Also check the preferred subtitle language: if it is set to forced only, regular subtitles exist but are not switched on automatically. Pick them from the subtitle menu during playback.
    Can Jellyfin read subtitles from a Subs folder?
    No. Jellyfin looks for external subtitles in the same folder as the video file (and its own metadata folder), not in subfolders. Move the files next to the video and name them Video name.en.srt.
    How do I fix subtitles that are out of sync?
    If the delay is constant, shift the timings: VLC's G and H keys, Kodi's subtitle offset, or Subtitle Edit to save it permanently. If the delay grows over time, convert the frame rate (often 23.976 to 25 fps). If it breaks after a particular scene, you have a subtitle for a different cut and need one made for your version.