Plex Naming Guide: Movies, TV Shows, Anime & Music (2026)

Plex Naming Fundamentals

Before diving into per-media patterns, understand how Plex's scanner actually thinks. Two things determine whether a file gets matched: the folder it lives in, and the filename itself. Both matter, and Plex sometimes uses one to fix gaps in the other.

Folder structure vs filename

Folder structure tells Plex what a file is — a movie, a TV episode, an album. The filename then tells it which one. Movies are matched primarily on the filename (with year as the strongest signal). TV episodes are matched on the season folder + the sXXeYY token in the filename. Music is matched on a combination of ID3 tags and the Artist/Album/Track folder hierarchy. This means a perfectly named file in the wrong folder will fail. So will a chaotic filename in a perfect folder. Get both right and Plex matches with confidence in under a second per file.

How the Plex scanner thinks

The Plex scanner pipeline runs in three stages. First, it groups files into "items" using your folder structure and naming. Second, it queries the configured agent (TMDB for movies, TVDB or TMDB for shows, plus the music agent for tracks) to fetch metadata. Third, it stores the match and downloads artwork. Each stage has its own failure modes. Bad folder structure → grouping failure (one show becomes 12 shows, or two movies merge into one). Bad filename → agent query returns the wrong title or no match at all. Missing artwork even after a clean match usually means the agent succeeded but the artwork CDN was slow — refresh metadata to retry.

The four rules that prevent 95% of problems

Four rules prevent 95% of Plex matching problems. Apply them everywhere and you almost never see "unmatched" again.

Casino Royale.mkv

Casino Royale (2006).mkv

Breaking Bad Ep 1.mkv

Breaking Bad - s01e01.mkv

TV/All My Shows/...

TV/Breaking Bad (2008)/Season 01/...

01.mp3 (no tags)

01 - Speak to Me.flac (full ID3 tags)

Need it spelled out from zero? step-by-step walkthrough.

Naming Movies for Plex

Movies are the easiest media type to get right because Plex pulls metadata almost entirely from the filename and folder. There are two valid layouts — folder-per-movie (recommended) and flat — plus extensions for multi-version, editions, and special features.

Folder structure

Plex's recommended layout puts each movie in its own folder, named after the movie with its release year in parentheses. The video file inside repeats that name. Subtitles, trailers, and extras live alongside it.

Movies/
├── Blade Runner (1982)/
│   ├── Blade Runner (1982).mkv
│   ├── Blade Runner (1982).en.srt
│   └── trailer.mp4
├── Blade Runner 2049 (2017)/
│   └── Blade Runner 2049 (2017).mkv
└── Dune (1984)/
    └── Dune (1984).mkv

The folder name is what Plex reads first. The internal filename is a fallback. Keeping them identical is the cleanest pattern and the one Plex's docs explicitly recommend.

The year is non-negotiable

The year is non-negotiable. Plex uses TMDB as its default movie agent, and TMDB has thousands of duplicate titles distinguishable only by year. "Dune (1984)" and "Dune (2021)" share zero metadata; without the year, Plex picks one at random based on TMDB's popularity ranking, which is almost never what you want. Put the year in parentheses immediately after the title, with a single space before the opening paren: "Title (YYYY)". Not "Title YYYY", not "Title [YYYY]", not "Title.YYYY". The parentheses are part of Plex's matching regex.

Multi-version (1080p + 4K)

Plex supports multiple versions of the same movie in a single library entry — useful for storing a 1080p and a 4K copy without duplicating the metadata. There are two official patterns.

Pattern A — Resolution suffix in the filename:

Avatar (2009)/
├── Avatar (2009) - 1080p.mkv
└── Avatar (2009) - 2160p.mkv

Pattern B — Subfolders per version (cleaner for many edits):

Avatar (2009)/
├── 1080p/
│   └── Avatar (2009).mkv
└── 2160p/
    └── Avatar (2009).mkv

Plex displays both versions in a single movie card with a version picker. Plex Pass users with Direct Play to a 4K device get the 4K file; everyone else gets the 1080p without transcoding. This is the single biggest quality-of-life improvement most libraries are missing.

Editions (director's cut, theatrical, extended)

For director's cuts, extended cuts, theatrical releases, and the like, Plex 2024+ supports an explicit edition tag inside curly braces:

Movies/
├── Blade Runner (1982)/
│   ├── Blade Runner (1982) - {edition-Final Cut}.mkv
│   └── Blade Runner (1982) - {edition-Theatrical}.mkv
└── Apocalypse Now (1979)/
    ├── Apocalypse Now (1979) - {edition-Theatrical}.mkv
    └── Apocalypse Now (1979) - {edition-Redux}.mkv

These show up as separate movies in your library — not merged versions like the resolution pattern. Use editions when the runtime, content, or narrative differs meaningfully; use multi-version when it's the same film at different quality.

Concerts and stand-up specials

Concert films and stand-up specials need a fake year and live in your Movies library, not a separate one. Plex doesn't have a dedicated "concerts" media type and TMDB lists most concerts under their release year. Keep the same "Title (Year).ext" pattern. For stand-up specials that don't have a TMDB entry, you may need to lock the metadata manually after the scanner gives up. Plex Web → ⋯ menu → Fix Match → Search by name.

Five movie naming mistakes

The five mistakes that account for most movie matching failures: 1. Year missing or in the wrong format. "Inception 2010.mkv" without parentheses works only by luck. 2. Special characters from scene releases left in: "Inception.2010.BluRay.x264-SPARKS.mkv" matches but is ugly. Plex parses it; humans don't read it well. 3. Movie file in the root of the library instead of a folder. Works for the scan but breaks subtitles and extras detection. 4. Both 1080p and 2160p versions named identically without the resolution suffix. Plex picks one randomly. 5. Edition tag using parentheses or brackets instead of curly braces. Only "{edition-X}" is parsed.

Real-world examples

Movies/
├── The Matrix (1999)/
│   └── The Matrix (1999).mkv
├── Dune (1984)/
│   └── Dune (1984) - {edition-Theatrical Cut}.mkv
├── Dune (2021)/
│   ├── Dune (2021) - 1080p.mkv
│   └── Dune (2021) - 2160p.mkv
├── Apocalypse Now (1979)/
│   ├── Apocalypse Now (1979) - {edition-Theatrical}.mkv
│   └── Apocalypse Now (1979) - {edition-Redux}.mkv
└── Lord of the Rings - The Fellowship of the Ring (2001)/
    ├── Lord of the Rings - The Fellowship of the Ring (2001) - {edition-Theatrical} - 2160p.mkv
    └── Lord of the Rings - The Fellowship of the Ring (2001) - {edition-Extended} - 2160p.mkv

Prefer a desktop tool? the FileBot way.

Naming TV Shows for Plex

TV is where most libraries break. The folder hierarchy is mandatory, the season-episode token is rigid, and the edge cases — specials, date-based shows, multi-episode files, mini-series — each have their own pattern. Get them right once and Plex never asks again.

Folder structure (mandatory)

The required layout is two levels deep: a show folder, then one season folder per season. Plex will not group episodes correctly if you put everything in a single folder.

TV Shows/
├── Breaking Bad (2008)/
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag....mkv
│   ├── Season 02/
│   │   └── Breaking Bad - s02e01.mkv
│   └── Specials/
│       └── Breaking Bad - s00e01 - Behind the Scenes.mkv
└── The Wire (2002)/
    └── Season 01/
        └── The Wire - s01e01.mkv

Show folder name format: "Show Title (Year)". The year disambiguates remakes (think "The Office (2001)" UK vs "The Office (2005)" US). Season folder format: "Season XX" with two-digit zero-padding, or "Specials" for season 0.

Filename format: sXXeYY

The episode filename token Plex understands is sXXeYY — lowercase 's' and 'e', two-digit zero-padded numbers. Variations Plex also accepts include SXXEYY (uppercase), Season XX Episode YY (verbose), and dot-separated 1x01. But mixing styles within the same show confuses some scanners. Pick one and stick with it; lowercase sXXeYY is the safest. Add the episode title after a dash for readability — it's optional for matching but reads better in Plex's UI when metadata is slow to load:

Breaking Bad - s05e14 - Ozymandias.mkv

The episode title is NOT used for matching. The metadata agent overrides whatever you wrote with the official title from TVDB or TMDB.

Specials and OVAs

Specials, OVAs, behind-the-scenes, and extras go in a "Specials" folder (literal name) or "Season 00". Plex treats both as season zero. Inside, name them s00e01, s00e02, etc. The order should match the official "specials" listing on TVDB. Some shows have specials that air between seasons. You can use the absolute air-date order, or follow TVDB's specials numbering. Plex's TVDB agent uses TVDB's numbering by default, so check there first to avoid mismatches.

Daily shows (date-based)

Daily shows (The Daily Show, late-night talk shows, daily news) don't fit the sXXeYY pattern because episodes don't have season/episode numbers — they have dates. Plex supports a date-based naming scheme:

The Daily Show (1996)/
├── Season 28/
│   ├── The Daily Show - 2024-01-15.mkv
│   └── The Daily Show - 2024-01-16.mkv

Format the date as YYYY-MM-DD. Plex uses this to match episodes against TVDB's daily-show date index. The library section must have the TVDB agent selected; the TMDB agent has limited support for daily shows.

Multi-episode files

For double-episodes or season finales that span two episode slots in one file, use the range syntax:

Breaking Bad - s05e15-e16 - Granite State + Felina.mkv

Plex creates a single playable file that maps to both episodes in the metadata. You can also use s05e15-s05e16 (full repeat) and Plex accepts both, but the range form is cleaner.

Mini-series

Mini-series with a single season (Chernobyl, Band of Brothers, The Queen's Gambit) follow the same pattern as regular shows, with "Season 01" as the only season folder. Don't be tempted to put episodes in the root of the show folder — Plex's scanner expects the season folder layer.

Common TV failures and fixes

The most common TV scanner failures and their causes: — "Episode unmatched" but the season is fine: filename token is malformed. Check that sXXeYY is lowercase and zero-padded. — Whole season unmatched: folder name doesn't start with "Season ". "S1" or "Season1" doesn't match. The space is required. — Wrong show matched: missing year on a common title. "The Office" matches the more popular US version regardless of which one you have. Add (2001) or (2005) to the show folder. — Episodes grouped into season 1 even though they're season 2 and beyond: files are in the show root, not in season folders. Move each file into "Season XX/". — "Episode title" shown is wrong: the metadata agent overrode your filename. This is by design. If the title is wrong on TVDB itself, fix it on TVDB and refresh metadata. Plex sends a daily cache refresh request, so changes propagate within 24h.

Real-world examples

TV Shows/
├── Breaking Bad (2008)/
│   ├── Season 01/
│   │   ├── Breaking Bad - s01e01 - Pilot.mkv
│   │   └── Breaking Bad - s01e02 - Cat's in the Bag....mkv
│   ├── Season 05/
│   │   └── Breaking Bad - s05e15-e16 - Granite State + Felina.mkv
│   └── Specials/
│       └── Breaking Bad - s00e01 - No Half Measures.mkv
├── The Office (2005)/
│   └── Season 03/
│       └── The Office - s03e12 - Back from Vacation.mkv
├── Chernobyl (2019)/
│   └── Season 01/
│       └── Chernobyl - s01e01 - 1:23:45.mkv
└── The Daily Show (1996)/
    └── Season 29/
        └── The Daily Show - 2024-03-15.mkv

Naming Anime for Plex

Anime is where Plex's default scanner falls apart and Reddit threads multiply. The core problem: anime is tracked in three databases (TMDB, TVDB, AniDB) that disagree about what counts as a season, what counts as a series, and how to number episodes. Whichever database your Plex agent queries shapes everything that follows. Two valid strategies exist; pick one and commit.

The core challenge

A concrete example: One Piece. AniDB lists it as one continuous series of 1,000+ episodes with absolute numbering (episode 1, 2, 3 … 1064). TVDB splits it into 21+ "seasons" along production arcs. TMDB does its own thing, partially mirroring TVDB. If your Plex anime library uses the TMDB agent (default) and your filenames use absolute numbering ("One Piece - 1064.mkv"), nothing matches because TMDB expects season-and-episode. If your filenames use TVDB's season-and-episode mapping ("One Piece - s21e62.mkv") and you switch to a different agent, the mapping breaks. Two strategies to escape the trap, in order of effort: Strategy 1 — Use TVDB seasons/episodes everywhere, accept that some episode numbers feel arbitrary. Lowest setup cost. Lowest fidelity for absolute-numbered shows. Strategy 2 — Install the HAMA scanner and agent (community-maintained on GitHub) which speaks AniDB natively. Highest fidelity. Manual install. Recommended for serious anime libraries.

Absolute numbering with HAMA

With HAMA installed, you can name anime files using absolute episode numbers and HAMA maps them correctly:

Anime/
├── One Piece [anidb-69]/
│   ├── Season 01/
│   │   ├── One Piece - s01e001.mkv
│   │   ├── One Piece - s01e002.mkv
│   │   └── ...

The [anidb-69] suffix is HAMA's explicit ID hint — it forces the agent to use the AniDB entry for One Piece (ID 69 in their catalog) instead of guessing from the title. Use it for any show with title ambiguity (multiple seasons named the same, alternate spellings). For absolute numbering without HAMA — using just Plex's default agent — name files with the absolute number in the episode slot of season 1: "Show - s01e0064.mkv". Plex will display them as season 1 episodes 1 through N, which loses season context but at least matches.

HAMA setup in 5 steps

HAMA setup in five steps: 1. Download HAMA from github.com/ZeroQI/Hama.bundle and place in Plex's "Plug-ins" folder. 2. Download Absolute Series Scanner (ASS) from github.com/ZeroQI/Absolute-Series-Scanner and place in Plex's "Scanners/Series" folder. 3. Restart the Plex server. 4. Create a new library section, type "TV Shows", and in the advanced settings set the scanner to "Absolute Series Scanner" and the agent to "HAMA". 5. Point the section at your anime folder and run a scan. HAMA reads AniDB IDs, MyAnimeList IDs, and TVDB IDs from the folder name in brackets. You can mix and match per series. AniDB is best for naming fidelity; TVDB is best for shows with English dub metadata.

Reference: HAMA scanner (GitHub)

Split seasons (Attack on Titan)

Attack on Titan is the canonical split-season problem. AniDB and TVDB disagree about whether "Final Season" is season 4, season 5, or its own series. The Final Season was broken into three "parts" each treated differently across databases. Solution: pick the database that matches how you think about the show, install the matching agent if needed (HAMA for AniDB, default for TVDB), and stick with it for all anime. Mixing databases inside one library breaks more than it fixes. If you're a TVDB user and the season structure feels wrong, check the show's "Aliases" section on TVDB — sometimes the maintained alias points to the structure most viewers expect.

OVAs and tie-in movies

OVAs, movies tied to a series, and specials each go in Season 00 with sequential s00e01, s00e02 numbering. The order follows the database you're using. For movies tied to a series (Demon Slayer: Mugen Train, your name., the multiple Naruto films), there's an ongoing debate about whether they belong in the TV library as specials or in the Movies library as standalone films. The Movies library is usually simpler — fewer scanner edge cases. The downside: they don't show up in the parent series view.

Sub vs dub

Sub vs dub naming doesn't change the file matching but affects which audio track plays by default. Plex picks the first audio track unless you've set a default in the file or in your account preferences. If you stock both sub-only and dub versions of the same episode, use multi-version naming (resolution-suffix pattern) with audio language in the suffix:

Show - s01e01 - JPN.mkv
Show - s01e01 - ENG.mkv

These get merged into a single episode entry with a version picker, exactly like 1080p/2160p movie versions.

Real-world examples

HAMA-based library:
Anime/
├── One Piece [anidb-69]/
│   ├── Season 01/
│   │   ├── One Piece - s01e001.mkv
│   │   └── One Piece - s01e002.mkv
│   └── Season 00/
│       └── One Piece - s00e001 - Movie 14: Stampede.mkv
└── Attack on Titan [anidb-9541]/
    ├── Season 01/
    └── Season 02/

TVDB-based library (default agent, no HAMA):
Anime/
├── Demon Slayer (2019)/
│   ├── Season 01/
│   │   ├── Demon Slayer - s01e01.mkv
│   │   └── Demon Slayer - s01e02.mkv
│   └── Season 02/
│       └── Demon Slayer - s02e01 - Mugen Train Arc.mkv
└── Spy x Family (2022)/
    └── Season 01/
        └── Spy x Family - s01e01.mkv

Same library, different player? Kodi and Jellyfin equivalents.

Naming Music for Plex and Plexamp

Music is the one media type where filenames are secondary. Plex's music agent reads ID3 tags first and falls back to folder structure when tags are missing or wrong. The cleanest libraries get both right; tag-only or folder-only libraries develop weird gaps.

Folder structure

The recommended structure mirrors how most music apps think about libraries: artist, then album, then track.

Music/
├── Pink Floyd/
│   ├── The Dark Side of the Moon (1973)/
│   │   ├── 01 - Speak to Me.flac
│   │   ├── 02 - Breathe (In the Air).flac
│   │   └── ...
│   └── Wish You Were Here (1975)/
│       └── 01 - Shine On You Crazy Diamond Pts. 1-5.flac
└── Daft Punk/
    └── Random Access Memories (2013)/
        └── 01 - Give Life Back to Music.flac

The album year in parentheses is optional but useful — it disambiguates re-releases and helps match the right MusicBrainz release. Track filenames start with a zero-padded track number followed by a dash and the title.

ID3 tags come first

ID3 tags are what Plex's music agent actually reads. The required tags are: artist, album, title, track number. Recommended additional tags: album artist (different from track artist on compilations), year, genre, disc number. Renaming files without fixing tags doesn't help Plex match correctly. If your tags are wrong, install MusicBrainz Picard (free) or Mp3tag (free on Windows) and run a tag rewrite first, then handle filenames second. RenameFlow's music mode reads MusicBrainz and updates filenames; it does not write ID3 tags, so use it after a tagger.

Various Artists (compilations, soundtracks)

Compilations and soundtracks need a "Various Artists" album artist or they explode into dozens of single-track "artists" in your library view. The setting lives in ID3: Tag: Album Artist = "Various Artists" Tag: Artist = (the individual track artist) Folder pattern then becomes:

Music/
└── Various Artists/
    └── Rocky IV Soundtrack (1985)/
        ├── 01 - Burning Heart - Survivor.flac
        └── 02 - Heart's on Fire - John Cafferty.flac

Plex displays the album under "Various Artists" but each track shows its real performer.

Track numbering

Track numbers go first in the filename, two-digit zero-padded. Don't skip numbers (no 1, 3, 4 — that breaks playback order on agents that re-sort alphabetically when track tags are missing). Filename pattern: "01 - Track Title.ext" or just "01 Track Title.ext". Both work. Avoid putting the artist in every track filename — it's redundant with the folder and clutters the UI when Plexamp falls back to filename display.

Multi-disc albums

Multi-disc albums use a "Disc XX" subfolder layer between album and tracks, and the ID3 tag "Disc Number" should be set on every file:

Music/
└── Tool/
    └── Lateralus (2001)/
        ├── Disc 01/
        │   ├── 01 - The Grudge.flac
        │   └── ...
        └── Disc 02/
            └── 01 - Faaip de Oiad.flac

Plexamp merges these into a continuous album view with disc dividers. Without the disc tag, tracks from disc 2 collide with disc 1 (two "track 01"s, two "track 02"s, and Plex picks whichever it sees first).

Real-world examples

Music/
├── Pink Floyd/
│   ├── The Dark Side of the Moon (1973)/
│   │   ├── 01 - Speak to Me.flac
│   │   ├── 02 - Breathe (In the Air).flac
│   │   └── 10 - Eclipse.flac
│   └── The Wall (1979)/
│       ├── Disc 01/
│       │   ├── 01 - In the Flesh?.flac
│       │   └── ...
│       └── Disc 02/
│           └── 01 - Hey You.flac
├── Various Artists/
│   └── Pulp Fiction Soundtrack (1994)/
│       ├── 01 - Pumpkin and Honey Bunny - Tim Roth.flac
│       └── 02 - Misirlou - Dick Dale.flac
└── Daft Punk/
    └── Random Access Memories (2013)/
        ├── 01 - Give Life Back to Music.flac
        └── 13 - Contact.flac

Plex Naming Troubleshooting

Even with perfect naming, libraries break in predictable ways. Here are the six failures that cover roughly 90% of real-world Plex naming complaints, with the exact fix steps.

The 60-Second Alternative

Everything above is the manual way: understand the rules, type the right filenames, fix the edge cases yourself. Done once carefully, a library stays clean for years. But "carefully" rarely survives a 2000-file backlog.

The manual way

The honest summary: by hand, expect about 1 minute per movie or episode once you're fluent — looking up the year on TMDB or IMDb, typing the canonical title, getting the sXXeYY format right. A 500-episode show is eight hours of typing. A mixed library of 2,000 files is a weekend.

The 60-second way

RenameFlow does the same work in seconds. Drop a folder, it parses each filename, queries TMDB/TheTVDB/AniDB/MusicBrainz in parallel, displays the proposed Plex-ready name, and renames the files locally when you confirm. Nothing uploads — the File System Access API does the rename on your own disk. Free up to 15 files per day; one-time Lifetime €49 for unlimited. The naming patterns are exactly the ones in this guide, validated against every example shown above. If you've already typed half your library by hand, RenameFlow can finish the rest in 60 seconds.

See RenameFlow plans.

Plex Naming — Frequently Asked Questions

→ see all FAQs

Continue Reading

• → Step-by-step renaming walkthrough
• → RenameFlow vs FileBot detailed comparison
• → Kodi and Jellyfin naming equivalents
• → All RenameFlow FAQs

Official references: Plex naming convention (official) · Plex multi-version naming (official)