Emby guide

    Emby naming guide: folder structure and file names for movies, TV shows and anime

    Emby does not guess what a file is from its content: it reads folder and file names, then looks them up on metadata providers such as TheMovieDb and TheTVDB. When a movie shows the wrong poster or half a season is missing, the cause is almost always a name Emby could not parse. This guide gives you the exact patterns Emby's scanner expects, based on the official Emby naming documentation, with examples you can copy.

    Three habits prevent most problems before they start: choose the right content type when you create the library (Movies or TV shows), give every movie and every series its own folder, and keep release clutter (group tags, hashes, codecs) out of names where it can be mistaken for an episode number. Everything below builds on those.

    Updated November 22, 202612 min read

    Emby movie naming and folder structure

    Emby recommends one folder per movie, with the folder and the main video file sharing the same name: the title, a space, then the release year in parentheses.

    Recommended movie layout
    Movies/
    ├── Dune (2021)/
    │   └── Dune (2021).mkv
    ├── Inception (2010)/
    │   └── Inception (2010).mkv
    └── The Matrix (1999)/
        └── The Matrix (1999).mp4
    • Always add the year. It is how Emby separates remakes such as Dune (1984) and Dune (2021), or The Lion King (1994) and The Lion King (2019).
    • Use the title as the metadata provider lists it, minus characters your file system rejects. On Windows, drop the colon: Mission Impossible - Dead Reckoning Part One (2023).
    • Grouping folders are allowed. You can put folders such as Movies/Marvel/ or Movies/Kids/ between the library root and the movie folders. Emby only shows them in the Folders view.
    • Set the library content type to Movies. A movie library that is set to TV shows, or the other way round, is a frequent reason for nothing matching at all.

    Movies split across several files

    If a movie is split into parts, Emby stacks them into one item when they share a name and end with a part suffix: part1, cd1, dvd1, pt1, disk1 or disc1 (or a letter from A to D). All parts must sit in the same movie folder, with no other videos in that folder.

    Multi-part movie
    Gone with the Wind (1939)/
    ├── Gone with the Wind (1939)-part1.mkv
    └── Gone with the Wind (1939)-part2.mkv

    DVD, Blu-ray and ISO files

    A movie folder that contains a VIDEO_TS folder (or a VIDEO_TS.IFO file) is read as a DVD, and one that contains a BDMV folder is read as a Blu-ray. Name the outer folder Alien (1979) and never rename the files inside the disc structure. For disc images, add the type before the extension: Alien (1979).dvd.iso or Léon (1994).bluray.iso. An ISO without a tag is assumed to be a DVD.

    Loose movie files in one shared folder can be scanned, but version grouping, extras folders and multi-part stacking all rely on the one-folder-per-movie layout. If you plan to use any of those, give each movie its own folder from the start.

    Emby TV show naming: seasons, specials and multi-episode files

    For TV, Emby's documentation is strict: every show needs its own folder under the library path. Inside it, use one folder per season and put the season and episode number in every file name.

    Recommended TV layout
    TV Shows/
    └── Breaking Bad (2008)/
        ├── Season 00/
        │   └── Breaking Bad - S00E01.mkv
        ├── Season 01/
        │   ├── Breaking Bad - S01E01 - Pilot.mkv
        │   └── Breaking Bad - S01E02 - Cat's in the Bag.mkv
        └── Season 02/
            └── Breaking Bad - S02E01 - Seven Thirty-Seven.mkv

    Emby recognizes several episode patterns, including S01E01 (upper or lower case), 1x01 and s01.e01. The form above, Show - S01E01 - Episode Title.ext, is the most reliable and also works in Plex and Jellyfin. The episode title is optional: Emby matches on the numbers, so Breaking Bad - S01E01.mkv works too. Season folders can be called Season 1 or Season 01.

    Add the first-air year to the show folder whenever a title has been reused: Battlestar Galactica (1978) and Battlestar Galactica (2003), or The Office (2005) for the US version.

    Specials and Season 00

    Specials go into a folder named Season 00 (Emby also accepts Season 0 and Specials) and are numbered S00E01, S00E02 and so on. The numbers must match the specials list of the provider your library uses, because Emby looks them up exactly like regular episodes.

    Prefer Season 00 over Specials. The word specials is also on Emby's list of extras folder names, so Season 00 is the unambiguous choice.

    Multi-episode files

    When one file holds two or more episodes (a double-length pilot, for example), write the range in the name: S01E01-E02, S01E01E02 or 1x01 - 1x02. All episodes in one file must belong to the same season.

    Two episodes in one file
    Lost (2004)/
    └── Season 01/
        ├── Lost - S01E01-E02 - Pilot.mkv
        └── Lost - S01E03 - Tabula Rasa.mkv

    Daily and date-based shows

    Talk shows and news programs are often listed by air date rather than episode number. Emby reads dates such as 2024.11.14, 2024-11-14 or 14.11.2024 in the file name, for example The Daily Show - 2024-11-14.mkv.

    Renaming a whole season by hand is slow; the TV episode renaming guide covers batch methods.

    Emby anime naming

    Emby has no separate anime naming scheme: anime uses the same series layout as any other show. The hard part is numbering. Fansub releases usually carry absolute episode numbers, such as [Group] One Piece - 1071 [1080p][A1B2C3D4].mkv, while TheTVDB and TheMovieDb split most shows into seasons.

    The reliable option: season numbering

    Emby gets anime right most often when files follow the season split of the metadata provider your library uses (the first enabled series downloader in the library settings). Check the season and episode numbers on that provider before renaming, because TheTVDB and TheMovieDb do not always split seasons the same way.

    Anime in season layout
    Anime/
    └── Attack on Titan (2013)/
        ├── Season 01/
        │   └── Attack on Titan - S01E01.mkv
        └── Season 04/
            └── Attack on Titan - S04E01 - The Other Side of the Sea.mkv

    Absolute numbering and display order

    For very long shows such as One Piece or Detective Conan, splitting hundreds of episodes into seasons is tedious. Emby can display a series in absolute order: open the series, choose Edit metadata, set the display order to Absolute, then refresh its metadata. This relies on TheTVDB's absolute order, so TheTVDB must be an enabled metadata downloader for that library.

    Treat it as a fallback, not the default. The setting changes how episodes are ordered; it does not make Emby read any number in any position. Users on the Emby forums report that specials (which only have an aired number on TheTVDB) and episode numbers above 100 are the usual trouble spots. A bare 101 can be read as season 1, episode 1. Test on a few files before renaming a whole series.

    Strip CRC32 hashes like [A1B2C3D4], group tags and resolutions from anime file names. Emby forum threads show hashes and numbers like 1080 being read as season or episode numbers, which leads to episodes landing in the wrong season or not appearing at all.

    Add TMDB, TVDB or IMDb IDs to Emby folder names

    When a title is ambiguous (remakes, shows that share a name, foreign or very short titles), put the provider ID in the folder name. Emby then uses the ID directly instead of searching by title, and a later metadata refresh will not swap your movie for a different one.

    ProviderMovie folderSeries folder
    TheMovieDbCasino Royale (2006) [tmdbid=36557]Breaking Bad (2008) [tmdbid=1396]
    TheTVDBrarely used for moviesBreaking Bad (2008) [tvdbid=81189]
    IMDbCasino Royale (2006) [imdbid=tt0381061]Breaking Bad (2008) [imdbid=tt0903747]

    Emby is flexible about the syntax: square brackets or curly braces, = or -, and the short names tmdb and tvdb all work. So [tmdbid=36557], [tmdbid-36557] and {tmdb-36557} mean the same thing. That makes the Plex style ({tmdb-36557}) and the Jellyfin style ([tmdbid-36557]) both usable in Emby, which helps if one library feeds several servers.

    The ID is in the provider's URL or page. On themoviedb.org, /movie/438631-dune means [tmdbid=438631]. On IMDb, copy the tt number from the address bar. On thetvdb.com, the series page shows the numeric ID.

    Put IDs on the movie or series folder. You do not need them on every episode file: once the series is matched, Emby uses the season and episode numbers.

    Emby multiple versions and editions

    Emby can group several files of the same movie (a 4K and a 1080p copy, or a theatrical cut and a director's cut) into one item with a version picker. Put every version in the same movie folder, start each file name with the exact folder name, then add a space, a hyphen, a space and a label. The label is what viewers see in the version list. Up to 8 versions are shown.

    Editions and resolutions as versions
    Blade Runner (1982)/
    ├── Blade Runner (1982) - Final Cut.mkv
    ├── Blade Runner (1982) - Theatrical Cut.mkv
    └── Blade Runner (1982) - 4K.mkv

    Episodes work the same way, with the label after the last hyphen: Breaking Bad - S01E01 - 1080p.mkv and Breaking Bad - S01E01 - 4K.mkv in the same season folder. 3D copies follow the pattern too, with the 3D format before the extension: 300 (2006) - 3D.hsbs.mp4.

    The prefix must match the folder name exactly, including the year, and the separator must be - with spaces. Blade Runner 1982 4K.mkv or Blade Runner (1982).4K.mkv will not be grouped as a version of Blade Runner (1982).

    Emby has no special edition tag: an edition is simply a version with a descriptive label. Plex uses a different {edition-Final Cut} tag, covered in the comparison below.

    Emby extras folder and trailers

    Bonus videos go into a subfolder of the movie or series folder. Emby recognizes these folder names: extras, trailers, behind the scenes, deleted scenes, featurettes, interviews, scenes, shorts and specials. Folders nested inside them are not supported. Every type ends up in the same Extras row on the item's page.

    Movie with extras
    Home Alone (1990)/
    ├── Home Alone (1990).mkv
    ├── trailers/
    │   └── Home Alone Trailer.mp4
    ├── behind the scenes/
    │   └── Making of Home Alone.mkv
    └── deleted scenes/
        └── Kevin at the Store.mkv

    File names inside extras folders are free text: Emby uses them as titles. For TV shows, extras folders can sit at the series, season or episode level, and Emby also reads suffixes on the file name: -trailer, -behindthescenes, -deleted, -featurette, -interview, -scene, -short and -other, as in Breaking Bad - S01E01-deleted.mkv. Emby does not look up provider metadata for episode-level extras.

    Emby advises putting the main movie file in its folder before adding extras, so the folder is identified from the movie and not from a trailer. When copying a new movie, copy the main file first or wait until everything is in place before scanning.

    Do not mix up specials and extras. A special that the provider lists as S00E05 belongs in Season 00 so it gets metadata. A clip that no provider lists (an interview, a blooper reel) belongs in an extras folder.

    Naming external subtitles for Emby

    External subtitles must use the same file name as the video, plus a language and optional flags before the extension, and sit in the same folder.

    Subtitles next to a movie
    Home Alone (1990)/
    ├── Home Alone (1990).mkv
    ├── Home Alone (1990).eng.srt
    ├── Home Alone (1990).eng.sdh.srt
    ├── Home Alone (1990).eng.forced.srt
    └── Home Alone (1990).spa.default.srt
    FlagMeaningExample
    .defaultTrack selected by defaultHome Alone (1990).spa.default.srt
    .forced or .foreignOnly foreign-language dialogue and signsHome Alone (1990).eng.forced.srt
    .sdhFor deaf and hard of hearing viewersHome Alone (1990).eng.sdh.srt

    Emby's own examples use a three-letter language code (spa) or the full language name (spanish), and regional variants such as zh-CN or zh-TW. Supported formats are SRT, ASS, SSA, VTT and SUB/IDX. Episodes follow the same rule: Breaking Bad - S01E01 - Pilot.eng.srt.

    If you rename a video, rename its subtitles to the same base name. A subtitle still called Breaking.Bad.S01E01.720p.eng.srt next to Breaking Bad - S01E01 - Pilot.mkv is no longer paired with it.

    For codes and flags across Plex, Jellyfin, Kodi and Emby in one place, see the subtitle naming guide.

    Library scans, wrong matches and missing episodes

    Scan after renaming

    Emby picks up changes through real-time monitoring (when it is enabled for the library and your storage reports changes) and through the scheduled library scan task. To force a scan, open Manage Emby Server, go to Library, open the library's menu and choose Scan library files. Network shares often do not report changes, so a manual scan is normal there.

    Emby can treat a renamed file as a new item, so watched status and resume points for that file may not carry over. Rename a collection before you start watching it, or check playback state after the scan.

    Fix a wrong match

    1. Open the wrongly matched movie or series, open its menu and choose Identify.
    2. Search by title and year, or enter the TMDB, TVDB or IMDb ID, and pick the right result.
    3. If old artwork or descriptions remain, run Refresh metadata on the item and choose to replace all metadata.
    4. Make the fix permanent by adding the ID to the folder name (for example [tmdbid=438631]), so a future refresh cannot pick the wrong title again.

    If many items match in the wrong language or from the wrong source, check the library's metadata settings: the preferred metadata language and the order of the metadata downloaders.

    Emby not recognizing episodes: checklist

    • The library content type is TV shows. A mixed content library only reads series that have season folders.
    • Each show has its own folder. Episodes are not loose at the library root.
    • Every episode name contains S01E01 or 1x01. An episode title alone is not enough.
    • Names contain no hashes, resolutions or group tags that can be read as numbers (see the anime section).
    • Your season numbers match the provider. If you have Season 02 and the provider lists those episodes as the second half of season 1, they get the wrong titles and artwork, or appear as unmatched.
    • A multi-episode file does not cross seasons.
    • The episode is not inside a folder Emby treats as extras, such as extras, trailers or specials.
    • The account Emby runs under can read the folder. Permission problems are common on NAS devices, Linux and Docker volumes.

    Emby vs Plex vs Jellyfin naming

    Jellyfin started in 2018 as a fork of Emby, so the two still share most rules. Plex agrees on the basics but differs on IDs, editions and some extras details. A library named with the basic rules works on all three.

    TopicEmbyPlexJellyfin
    MovieDune (2021)/Dune (2021).mkvSameSame
    EpisodeShow - S01E01 - Title.mkv in Season 01SameSame
    SpecialsSeason 00, Season 0 or SpecialsSeason 00 or SpecialsSeason 00 or Specials
    ID in folder[tmdbid=36557], [tmdbid-36557] or {tmdb-36557}{tmdb-36557}[tmdbid-36557]
    EditionsVersion label: Movie (Year) - Final Cut.mkv{edition-Final Cut} tagVersion label: Movie (Year) - Final Cut.mkv
    ExtrasFolders; file suffixes documented for TVFolders or suffixes such as -trailerFolders or suffixes such as -trailer
    Forced subtitles.forced or .foreign.forced.forced

    In practice: if Emby runs next to Plex, Plex-style {tmdb-36557} folders work for both. If Emby runs next to Jellyfin, [tmdbid-36557] works for both. Edition labels are the one place where Plex and Emby naming truly conflict.

    The details for the other servers are in the Plex naming guide and the Jellyfin naming guide.

    Rename files for Emby with RenameFlow

    Renaming hundreds of release-named files by hand is where most people give up. RenameFlow is a web app that runs in Chrome, Edge or Opera on a desktop computer and renames files in place on your disk. Your media is never uploaded: only the titles detected in file names are sent to the metadata services.

    It reads scene and release names (quality, source, codec, group), multi-episode files such as S01E01-E02, and falls back to the folder name when a file name is generic. It matches movies and series against TMDB and TheTVDB and anime against AniList, and you confirm or change every match before anything is renamed.

    There is no separate Emby preset, but the Plex and Jellyfin presets produce names Emby reads as they are: Dune (2021).mkv, Breaking Bad - S01E01 - Pilot.mkv, and Attack on Titan - S04E01.mkv for anime. With custom patterns (a Pro feature) you can add a version label, for example {title} ({year}) - {quality}.

    RenameFlow renames files only. It does not create, move or rename folders. You create the Dune (2021) or Breaking Bad (2008)/Season 01 folders yourself, add any [tmdbid=...] tags to them, and move the files in. Files inside a VIDEO_TS or BDMV structure are left alone.

    Its Subtitles module can also find subtitles on OpenSubtitles and save them next to your videos. The free plan covers 15 files a day and 3 subtitle downloads a month; see pricing for the paid plans.

    Get your library Emby-ready

    Rename movies, episodes and anime into clean names that Emby reads, right in your browser. Your files stay on your disk.

    Try RenameFlow free

    Frequently asked questions

    What is the correct Emby naming convention for movies?
    Put each movie in its own folder named Title (Year) and give the video file the same name, for example Dune (2021)/Dune (2021).mkv. The year separates remakes and improves matching. If the title is still ambiguous, add the TMDB ID to the folder: Dune (2021) [tmdbid=438631].
    How do I name TV show episodes for Emby?
    Use Show (Year)/Season 01/Show - S01E01 - Episode Title.mkv. Every show needs its own folder, and every file needs a season and episode number such as S01E01 or 1x01. The episode title is optional. Specials go in Season 00 as S00E01, S00E02 and so on.
    Why is Emby not recognizing my episodes?
    The usual causes are a library not set to TV shows, episodes without their own show folder, names with no S01E01 number, or release clutter such as hashes and resolutions being read as numbers. Season numbers that differ from the provider's also cause missing episodes. Fix the names, run Scan library files, then use Identify on any show that is still wrong.
    How do I add multiple versions of a movie in Emby?
    Put all versions in the same movie folder and name each one after the folder, followed by - and a label: Blade Runner (1982) - Final Cut.mkv and Blade Runner (1982) - 4K.mkv. Emby groups them into one movie and shows the labels in a version picker, up to 8 versions.
    Where do extras and trailers go in Emby?
    In a subfolder of the movie or series folder named extras, trailers, behind the scenes, deleted scenes, featurettes, interviews, scenes, shorts or specials. Do not nest folders inside them. For TV shows Emby also reads suffixes such as -trailer or -deleted at the end of a file name.
    Does Emby support TMDB or IMDb IDs in folder names?
    Yes. Add the ID in square brackets or curly braces, such as Casino Royale (2006) [tmdbid=36557] or Breaking Bad (2008) [tvdbid=81189]. Emby accepts = or - and short forms like {tmdb-36557}, so Plex-style and Jellyfin-style IDs both work.
    Is Emby naming the same as Plex and Jellyfin?
    Mostly. Movie folders, Season 01 folders and S01E01 episode names are the same on all three. The differences are in details: the ID tag syntax, editions (Plex uses {edition-...}, Emby and Jellyfin use a - Label suffix) and subtitle flags (Emby also accepts .foreign for forced subtitles).
    How should I name anime for Emby?
    Use the normal series layout and follow the season split of your metadata provider, for example Attack on Titan (2013)/Season 04/Attack on Titan - S04E01.mkv. Remove group tags, CRC32 hashes and resolutions from the names. For very long shows you can switch the series display order to Absolute in Edit metadata, but test it on a few episodes first.