Movies

Movies can be added to a Jellyfin server using the "Movies" library type.

Most common video formats are supported by Jellyfin, such as mp4 and mkv. In addition, VIDEO_TS and BDMV folders are supported for movies and music videos. VIDEO_TS or BDMV folders do not support multiple versions, multiple parts or external subtitle/audio tracks.

.iso files and other disc image formats should work, but are not supported. It is recommended that disc image formats be remuxed into mkv containers, or extracted into VIDEO_TS or BDMV folders.

File names containing special characters WILL cause problems. The following characters are known to cause issues: <, >, :, ", /, \, |, ?, *

Organization

Movies should be organized into individual folders for each movie. The folder can optionally contain extra files.

Movies
├── Best_Movie_Ever (2019)
│   ├── Best_Movie_Ever (2019).mp4
│   ├── Best_Movie_Ever (2019).nfo
│   ├── Best_Movie_Ever (2019).en_us.srt
│   ├── cover.png
│   └── theme.mp3
└── Movie (2021) [imdbid-tt12801262]
    ├── backdrop.jpg
    └── VIDEO_TS
        ├── VIDEO_TS.BUP
        ├── VIDEO_TS.IFO
        ├── VIDEO_TS.VOB
        ├── VTS_01_0.BUP
        ├── VTS_01_0.IFO
        ├── VTS_01_0.VOB
        ├── VTS_01_1.VOB
        └── VTS_01_2.VOB

Naming

The folder containing the movie should be named in the following format:

Movie Name (year) [external id]

The year and external id fields are optional, but they will help identify media more reliably.

The video files within the folder should have the same name has the folder. I.e. if the folder is named Super Fun Movie, the video file within should be named Super Fun Movie.mp4 (or any other extension), optionally with tags defined below.

• Example with name only: Jellyfin Documentary.mkv
• Example with year: Jellyfin Documentary (2030).mkv
• Example with external id: Jellyfin Documentary [imdbid-tt00000000].mkv
• Example with both year and external id: Jellyfin Documentary (2030) [imdbid-tt00000000].mkv

Metadata providers

Jellyfin fetches information about the media automatically from external metadata providers. The following metadata providers are supported:

• TheMovieDB (TMDB)
• TheTVDB (TVDB) (Shows Only)
• OMDb API (OMDB) (English Only)

Movies and show series can be named with a metadata provider ID to improve matching. They can be added to a file name in the following format:

• [imdbid-tt12345678]
• [tmdbid-12345]
• [tvdbid-67890]

Multiple IDs can be added in the same file / folder. e.g. Jellyfin Documentary [imdbid-tt00000000] [tmdbid-00000].mkv

External Subtitles and Audio Tracks

External Subtitles and audio tracks can be added with file suffixes.

/Movies
    /Film (1986)
        Film.mkv
        Film.default.srt
        Film.default.en.forced.ass
        Film.forced.en.dts
        Film.en.sdh.srt
        Film.English Commentary.en.mp3

/Shows
    /Show (2021)
        /Season 1
            Show (2021) S01E01 Title.avi
            Show (2021) S01E01 Title.ja.ass
            Show (2021) S01E01 Title.commentary.ja.aac

Each title/flag field can be a generic string, or a special flag. A file can have multiple flags, separated with .

Type	Flag
Default	default
Forced	forced, foreign
Hearing Impaired	sdh, cc, hi

hi collides with the Hindi language abbreviation. hi by itself will resolve as a Hindi language track, while hi in addition to another language identifier (such as title.en.hi.srt) will use the other language and tag it as hearing impaired.

Flags are ignored on containers with more than one stream.

Any arbitrary text not parsable to a language or flag will be combined and used as the title of the stream (if there is not a stream title already embedded in the file metadata). The last file in the above example will be parsed as an English mp3 audio stream with the title English Commentary.

Multiple Versions

Multiple versions of the same video can be stored together in the library using a file suffix in Movie and Music Video library types. The part before any suffixes MUST be exactly the same, including any years and/or metadata provider IDs.

Movie (2021) [imdbid-tt12801262]
├── Movie (2021) [imdbid-tt12801262] - 2160p.mp4
├── Movie (2021) [imdbid-tt12801262] - 1080p.mp4
└── Movie (2021) [imdbid-tt12801262] - Directors Cut.mp4

To distinguish between versions, each filename needs to have a space, hyphen, space, and then a label. Labels are not predetermined and can be made up by the user. The hyphen is required. Periods, commas and other characters are not supported.

Labels can optionally be placed between brackets with the same result as seen below.

Movies
└── Best_Movie_Ever (2019)
    ├── Best_Movie_Ever (2019) - [1080P].mp4
    ├── Best_Movie_Ever (2019) - [720P].mp4
    └── Best_Movie_Ever (2019) - [Directors Cut].mp4

If labels are not added to the end of filenames, as shown above, each file will be treated as a unique movie and not a version of the same movie.

Movie versions are presented in an alphabetically sorted list. An exception applies to resolution names, which are sorted in descending order from highest to lowest resolution. A version name qualifies as a resolution name when ending with either a p or an i. The first movie version in the list is the one selected by default. An example of sorting as seen below.

• Resolution sorting: 1080p, 2160p, 360p, 480p, 720p → 2160p, 1080p, 720p, 480p, 360p
• Named versions sorting: Extended Cut, Cinematic Cut, Director's Cut → Cinematic Cut, Director's Cut, Extended Cut

To group media manually, long-click or right-click media to highlight then select additional media to merge. Use the new bar that appears to 'Group Versions'.

3D Videos

3D Videos are identified using flags in the file name. To identify 3D content by filename, the first tag is 3D, which must be combined with one of the following tags to specify the specific 3D format:

Format	Flag
half side by side	hsbs
full side by side	fsbs
half top and bottom	htab
full top and bottom	ftab
Multiview Video Coding	mvc
Anaglyph	Not Supported

The tags are case-insensitive and must be surrounded by either a space, hyphen -, dot ., or underscore _.

Awesome 3D Movie (2022).3D.FTAB.mp4
Awesome 3D Movie (2022)_3D_htab.mp4
Awesome 3D Movie (2022)-3d-hsbs.mp4

S01E01 Some Episode.3d.ftab.mp4
S01E02 Some Other Episode.3d.ftab.mp4
S01E03 Yet another episode.3d.hsbs.mp4

Additionally, 3D filename tags can be combined with the grouping functionality in movie and music video libraries. All text before the hyphen must match the folder name.

Movies
└── Awesome 3D Movie (2022)
    ├── Awesome 3D Movie (2022) - 3D_FTAB.mp4
    ├── Awesome 3D Movie (2022) - 3D.hsbs.mp4
    └── Awesome 3D Movie (2022) - 1080p.mp4

Multiple Parts

Content that is split into multiple files can be stacked together if named correctly. Files should be named as follows:

Movie Name (2010)
├── Movie Name-cd1.mkv
├── Movie Name-cd2.mkv
└── Movie Name-cd3.mkv

Show (2025)
└──Season 1
    ├── S01E01-part-1.mkv
    └── S01E01-part-2.mkv

The separator is optional between <parttype> and <partnumber>. <partnumber> can be any number, or the letters a-d.

Supported part types are:

• cd
• dvd
• part
• pt
• disc
• disk

Supported separators are:

• (space)
• . (period)
• - (dash)
• _ (underscore)

This does not work with multiple versions or merging.

Extras

Extras can be added to movies, show series, show seasons, and music videos in a few different ways, as listed below.

Extras Folders

One of the cleanest ways of adding extras is to place them in subfolders within your media folders.

Supported folder types are:

• behind the scenes
• deleted scenes
• interviews
• scenes
• samples
• shorts
• featurettes
• clips
• other - Generic catch all for extras of an unknown type.
• extras - Generic catch all for extras of an unknown type.
• trailers

Best_Movie_Ever (2019)
├── Best_Movie_Ever (2019).mp4
├── behind the scenes
│   └── Finding the right score.mp4
└── extras
    └── Home recreation.mp4

Awesome TV Show (2024)
├── Season 1
│   ├── S01E01 episode name.mp4
│   └── trailers
│       └── trailer1.mp4
└── interviews
    └── Interview with the Director.mp4

File Name

Some types of extras support a special option if you only have a single of that type. These options are to name the filename a specific word when stored in the same folder.

Supported filenames are:

• trailer
• sample
• theme - Audio file of the theme song

Best_Movie_Ever (2019)
├── Best_Movie_Ever (2019) - 1080P.mp4
└── theme.mp3

Awesome TV Show (2024)
├── Season 1
│   ├── S01E01 episode name.mp4
│   └── theme.flac
└── sample.mp4

File Suffix

If you would rather keep everything in a single folder, you can append special suffixes to the filename which Jellyfin picks up and uses to identify the file as an extra. Note that, with a few noted exceptions, these suffixes DO NOT contain any spaces.

• -trailer
• .trailer
• _trailer
• trailer - This is a space followed by the word trailer
• -sample
• .sample
• _sample
• sample - This is a space followed by the word sample
• -scene
• -clip
• -interview
• -behindthescenes
• -deleted
• -deletedscene
• -featurette
• -short
• -other
• -extra

Best_Movie_Ever (2019)
├── Best_Movie_Ever (2019) - 1080P.mp4
├── Preview Trailer.trailer.mp4
└── Making of The Best Movie Ever-behindthescenes.mp4

Awesome TV Show (2024)
├── Season 1
│   ├── S01E01 episode name.mp4
│   └── Preview Trailer.trailer.mp4
└── making of awesome tv show-behindthescenes.mp4

External Images

Please refer to the external images section of the music docs while we work on a comprehensive page for external images