Plex Movie Naming Guide — Get Perfect Matches Every Time
Getting metadata wrong is the most common frustration for new Plex users. You add a movie library, scan it, and half your films show up with wrong posters, missing descriptions, or do not appear at all. The fix is almost always the same: rename your files to match the format Plex expects. This guide covers the exact naming conventions that produce perfect matches, from basic single-movie setups to complex multi-version and extras collections.
The Golden Rule: Movie Name (Year)
Every movie file should follow this pattern:
Movie Name (Year)/Movie Name (Year).ext
That means each movie lives in its own folder, and both the folder and the file share the same name including the release year in parentheses. Here are real examples:
The Matrix (1999)/The Matrix (1999).mkv
Inception (2010)/Inception (2010).mp4
Blade Runner 2049 (2017)/Blade Runner 2049 (2017).mkv
The year is critical. Without it, Plex often matches the wrong film. Consider "Dune" — there is a 1984 version and a 2021 version. Without the year, Plex has to guess, and it frequently guesses wrong.
Why Folders Matter
Technically, Plex can match movies that are loose files without individual folders. However, using per-movie folders is strongly recommended for several reasons:
- Extras support: Trailers, behind-the-scenes featurettes, and deleted scenes go inside the movie folder in a subfolder. Without a movie folder, there is nowhere to put them.
- Subtitle files: External subtitle files (
.srt,.ass,.sub) need to sit alongside the movie file. A per-movie folder keeps them organized. - Multi-version support: If you have both a 1080p and 4K version of a film, both files go in the same folder and Plex groups them together.
- Cleanliness: A flat directory with hundreds of movie files becomes impossible to manage manually.
Edition Tags
If you have a specific cut of a film — Director's Cut, Extended Edition, Theatrical Release — Plex supports edition tags in curly braces:
Blade Runner (1982)/Blade Runner (1982) {edition-Final Cut}.mkv
The Lord of the Rings - The Return of the King (2003)/The Lord of the Rings - The Return of the King (2003) {edition-Extended}.mkv
Apocalypse Now (1979)/Apocalypse Now (1979) {edition-Redux}.mkv
The {edition-Name} tag tells Plex to display the edition label in the interface. Without this tag, Plex has no way to distinguish between different cuts of the same film. The edition tag goes after the year and before the file extension.
Multi-Version Files
Want to keep both a 4K HDR version and a 1080p SDR version of the same movie? Place both files in the same folder. Plex will detect them as versions of the same film and let users choose during playback:
Interstellar (2014)/Interstellar (2014) - 2160p.mkv
Interstellar (2014)/Interstellar (2014) - 1080p.mkv
Plex recognizes common resolution and quality tags like 2160p, 1080p, 720p, 4K, HDR, and SDR. These labels appear in the playback version selector. If your files do not include these tags, Plex will still group them but label them generically as "Version 1" and "Version 2."
Extras and Bonus Content
Plex supports several types of extras stored in subfolders within the movie folder:
The Dark Knight (2008)/The Dark Knight (2008).mkv
The Dark Knight (2008)/Behind The Scenes/making-of.mkv
The Dark Knight (2008)/Deleted Scenes/hospital-extended.mkv
The Dark Knight (2008)/Trailers/theatrical-trailer.mkv
The Dark Knight (2008)/Featurettes/imax-sequence.mkv
Plex recognizes these subfolder names for extras: Behind The Scenes, Deleted Scenes, Featurettes, Interviews, Scenes, Shorts, Trailers, and Other. The subfolder name must match exactly (case-insensitive). Files inside these subfolders appear in the Extras section of the movie detail page.
3D Movie Tags
For 3D content, append the 3D format to the filename:
Avatar (2009)/Avatar (2009) - 3D-SBS.mkv
Avatar (2009)/Avatar (2009) - 3D-OU.mkv
Avatar (2009)/Avatar (2009) - 3D-HSBS.mkv
Supported 3D tags include 3D-SBS (side-by-side), 3D-OU (over-under), 3D-HSBS (half side-by-side), and 3D-HOU (half over-under). Plex uses these tags to flag the content as 3D so compatible players can enable the correct display mode.
Using TMDB and IMDB IDs
When Plex cannot match a movie by name alone — perhaps the title is very common, non-English, or abbreviated — you can include the TMDB or IMDB ID directly in the folder or filename:
Saw (2004) {tmdb-176}/Saw (2004) {tmdb-176}.mkv
Ran (1985) {imdb-tt0089881}/Ran (1985) {imdb-tt0089881}.mkv
To find the TMDB ID, search for the movie on themoviedb.org and look at the URL. The number at the end is the ID. For IMDB, use the tt identifier from the URL on imdb.com. Including the database ID guarantees Plex matches the correct entry, regardless of naming ambiguity.
Common Naming Mistakes
These are the errors that cause the most matching failures:
Missing Year
Bad: The Thing/The Thing.mkv
Good: The Thing (1982)/The Thing (1982).mkv
"The Thing" has multiple versions across different decades. Without the year, Plex picks one at random.
Extra Information in the Filename
Bad: The.Matrix.1999.BluRay.1080p.x264-GROUP.mkv
Good: The Matrix (1999)/The Matrix (1999).mkv
Release group tags, codec info, and source labels confuse Plex's scanner. Strip everything except the movie name, year, and optionally an edition or resolution tag.
Using Dots or Underscores Instead of Spaces
Bad: The_Dark_Knight_2008.mkv
Good: The Dark Knight (2008).mkv
While Plex can sometimes parse dots and underscores as spaces, it is not reliable. Use actual spaces in your filenames.
Wrong Year
Double-check the year, especially for movies released near the end of a calendar year. A film may have premiered at a festival in December 2023 but received its wide release in January 2024. Use the year that TMDB lists for the movie, not your personal recollection.
Articles in the Wrong Position
Bad: Matrix, The (1999)/Matrix, The (1999).mkv
Good: The Matrix (1999)/The Matrix (1999).mkv
Always use the full title as it appears on TMDB, including leading articles like "The," "A," or "An." Plex handles alphabetical sorting internally.
Bulk Renaming Tools
Renaming hundreds of poorly named files by hand is tedious. These tools automate the process:
- FileBot: The gold standard for media file renaming. It matches files against TMDB and TVDB, renames them in Plex format, and can move them into the correct folder structure. Available for Windows, Mac, and Linux (paid license).
- Tiny Media Manager: A free alternative that handles movies and TV shows. It downloads metadata and renames files according to customizable patterns.
- Bulk Rename Utility (Windows): A free tool for pattern-based renaming. Less intelligent than FileBot but useful for simple search-and-replace operations across many files.
After Renaming: Refresh Your Library
After renaming files, go to your Plex movie library, click the three-dot menu, and select "Scan Library Files." If individual movies still show wrong metadata, click the movie, select "Fix Match," and search manually by title and year. For persistent issues, select "Unmatch" first, then "Fix Match" to start the matching process from scratch.
Phlix — The Photo Browser for Plex
If you use Plex for photos, Phlix gives you a chronological timeline, year scrubber, 4K AirPlay slideshows, and offline downloads. Free to browse, Pro from $6.99/yr.
Download Phlix FreeiOS 17+ · Works with any Plex Media Server