Table Of Content
Plex is picky on purpose. Its scanner works by pattern-matching your filenames against TheMovieDB (TMDB) and TheTVDB databases. If the pattern drifts, the match breaks, and nothing shows up. Real users end up with chaos for three reasons:
.nfo, .xml, stale .srt subtitles) override Plex's own lookups and pin the wrong episode numbers.The fix is not to try harder with creative names. It is to surrender to Plex's naming convention and let the scanner do its job. If you want a shorter primer first, see our organizing TV shows walkthrough.
Last month I dropped The Office (US) S01 E01-E06.mp4 next to the.office.us.season1.ep7.avi and Plex silently split the show into two entries. That is the classic symptom of creative file naming. Watch for:
S01E01, 1x01, Episode 1, Ep.01 all in one folder.Season 01 vs season1 vs no folder at all.Multiply that across a few seasons and even you cannot find anything.
Even if filenames are perfect, leftover .nfo files from Kodi or Emby can override Plex's own database lookups. I once lost an entire season of a BBC mystery because a rogue .nfo insisted episode 3 was actually episode 11 in a different season. If "everything looks right" but Plex still misbehaves, hunt for stray sidecar files before anything else.
Here is the exact tree Plex's scanner expects for season-based shows. Memorize it.
/TV Shows
/Show Name (Year)
/Season 01
Show Name (Year) - S01E01.ext
Show Name (Year) - S01E02.ext
/Season 02
Show Name (Year) - S02E01.ext
Real example:
/TV Shows
/Breaking Bad (2008)
/Season 01
Breaking Bad (2008) - S01E01.mkv
Breaking Bad (2008) - S01E02.mkv
/Season 02
Breaking Bad (2008) - S02E01.mkv
Non-negotiable rules:
Battlestar Galactica (2004) vs Battlestar Galactica (1978). Without it, Plex guesses — and it guesses wrong on remakes.Season 01, Season 02 (English word, two-digit number) even for non-English libraries.Plex's scanner is a regex machine. Give it predictable patterns and it will reward you.
Standard episode:
Show Name (Year) - S01E01.ext
Optional episode title (recommended for better matching):
Band of Brothers (2001) - S01E01 - Currahee.mkv
Multi-episode file (one file, two or more episodes):
Show Name (Year) - S01E01-E02.ext
Episode split across multiple files:
Show Name (Year) - S01E01 - part1.ext
Show Name (Year) - S01E01 - part2.ext
Quick-reference rules:
S01E01, never S1E1..mkv, .mp4, .avi) does not affect matching, but .mkv and .mp4 play best across Plex clients.Specials are Plex's most common edge case. They belong in Season 00 — not Season 1, not the show root.
/Breaking Bad (2008)
/Season 00
Breaking Bad (2008) - S00E01.mkv (holiday special)
Breaking Bad (2008) - S00E02.mkv (making-of)
Mini-series and single-season limited shows: treat them like a regular Season 01. Name files S01E01, S01E02, etc.
For two-parters where both parts sit in one video file, use the combined code S01E01-E02. Plex will correctly mark it as covering both episodes.
Pro tip: Before you name a special, check how TheTVDB numbers it. If their Christmas special is S00E05, use S00E05, not your own guess. Mismatching their numbering is the single biggest cause of "specials in weird places."
Shows without a traditional season structure — The Daily Show, SNL weekly segments, nightly news — use date-based naming. The show folder is unchanged, but files look like:
/The Daily Show (1996)
/Season 2026
The Daily Show (1996) - 2026-04-13 - Guest Name.mkv
The scanner treats YYYY-MM-DD as the episode identifier. Make sure the library's agent supports date-based scanning (the default Plex TV Series agent does). Without the right agent, date-based episodes appear as unmatched.
Plex supports local extras via specific suffixes. Drop them in the show folder (not a season folder) using these exact suffixes:
/Breaking Bad (2008)
Breaking Bad (2008) - trailer.mkv
Breaking Bad (2008) - behindthescenes.mkv
Breaking Bad (2008) - deleted.mkv
Breaking Bad (2008) - featurette.mkv
Breaking Bad (2008) - interview.mkv
Or group them into subfolders named Trailers, Behind The Scenes, Deleted Scenes, Featurettes, Interviews. Plex surfaces them in the show's "Extras" tab automatically.
Since the 2021 rollout, the Plex TV Series agent (powered by TMDB + TVDB) is the default. In 2026 it is the only maintained agent. The legacy TheTVDB (Legacy) agent still exists but receives no new matching fixes.
To check or switch: open Plex Web → Settings → your TV library → Manage Library → Edit → Advanced → "Scanner" and "Agent."
When a show has an ambiguous title (The Office US vs UK, a 2026 reboot), append the database ID in curly braces to the folder name:
/The Office (2005) {tmdb-2316}
/The Office (2026) {tmdb-999999}
Plex honors the ID hint and skips its title-based guess entirely. Works for TVDB too: {tvdb-73244}.
If you have renamed everything correctly, removed stray .nfo files, and Plex still shows the wrong poster or episode list, run the Plex Dance. It forces Plex to drop all cached metadata for a show and re-match from scratch.
Plex now treats the folder as brand-new content and runs a fresh match. This fixes roughly 80% of stubborn "wrong show" and "merged shows" problems.
After years of trial and error, the rule of thumb: automate 90%, hand-fix the rest.
Automate when:
Hand-fix when:
Before you worry about names, make sure every file actually plays. A Plex library full of mismatched codecs, ancient AVIs, and unsupported HEVC profiles will still misbehave even with perfect naming — because clients transcode, fail, or skip files. That is where a free video converter built for Plex-friendly formats earns its keep.
If you have ever spent hours trying to get Plex to show the right poster, season number, or episode description, messy or missing metadata is almost always the cause. With UniFab TV Show Converter, adding and editing show metadata becomes a few-clicks job.
Instead of juggling separate NFO editors, UniFab writes title, year, cast, plot, and artwork directly into the video or as a paired NFO — pre-formatted for Plex, Kodi, and Emby.
A Plex library made of 720p AVIs, 1080p HEVC in 10-bit, and old .mov files will confuse clients no matter how tidy the folder tree is. UniFab TV Show Converter batches the cleanup:
.mp4 or .mkv — Plex's best friends).Why this matters for organization:
If part of your library is SD DVD rips or early-2000s SD TV captures, they look rough next to modern 1080p/4K releases. A dedicated AI video upscaler can upscale those old episodes to 1080p or 4K, denoise interlaced captures, and even convert SDR to HDR for OLED playback in Plex. Do the upscaling once, store the enhanced files, and the rest of your library finally feels consistent.
Full feature access, without watermark!
After installing UniFab, launch the application and navigate to the TV Show Converter section. Click the upload button to start adding your files.
Locate the folder containing your TV shows or episodes. Select the files you want to organize and upload them into UniFab. Adjust your settings as desired, then hit the Start button.
Once the conversion finishes, check your chosen output folder. Alongside your video files, you'll see a system info file that stores the metadata for each show or episode, helping keep everything organized.
Place each show in its own folder named Show Name (Year), with a subfolder for each season named Season 01, Season 02, and so on. Inside each season folder, name episode files Show Name (Year) - S01E01.ext. This structure lets Plex's scanner match every episode to TheMovieDB or TheTVDB reliably, including specials (which go in a Season 00 folder) and extras. Keeping the structure consistent is the single highest-leverage fix when you are figuring out plex how to organize tv shows at scale.
Use the pattern Show Name (Year) - SxxExx.ext with two-digit season and episode numbers — S01E01, not S1E1. You can optionally add the episode title for better matching: Band of Brothers (2001) - S01E01 - Currahee.mkv. The file extension does not affect recognition, but .mkv and .mp4 are the safest for Plex direct play across Apple TV, Fire TV, and smart TV clients.
All specials live in a Season 00 folder inside the show directory, named Show Name (Year) - S00E01.ext and upward. Match the numbering TheTVDB uses for each special — if their Christmas episode is S00E05, use S00E05. Unaired pilots and making-of featurettes count as specials too. Never put specials in Season 01; Plex will flag them as duplicate episodes or merge them incorrectly.
For shows without seasons (The Daily Show, SNL, nightly news), use date-based filenames: Show Name (Year) - YYYY-MM-DD - Guest.ext inside a Season YYYY folder grouped by broadcast year. Confirm the library's agent supports date-based scanning, which the default Plex TV Series agent does. Without the right agent, date-based episodes appear as unmatched even with correct filenames.
The Plex Dance is a manual reset that forces Plex to drop cached metadata for a show and re-match it from scratch. Use it when a show stubbornly shows the wrong poster, wrong episode list, or merges with another show even after correct naming. Steps: stop Plex, move the show folder out, rescan, empty the library Trash, stop Plex, move the folder back, and rescan. It fixes most stuck matches that simple refreshes cannot.
The most common causes are leftover .nfo or .xml sidecar files from Kodi or Emby that override Plex's lookups, a missing release year in the show folder, inconsistent two-digit padding (S1E1 vs S01E01), or using the wrong library type (Movies vs TV Shows) when you added the folder. Delete stray sidecars, confirm Show Name (Year) folder, and run a partial library scan before doing anything more drastic.
Use the Plex TV Series agent for any library built in 2026. It is actively maintained, pulls from both TMDB and TVDB, and handles edge cases like multi-source matches and mixed metadata. The legacy TheTVDB agent still works but receives no new fixes. Switching agents on an existing library will reshuffle matches, so only migrate if you are ready to re-verify affected shows.
Yes. Append the database ID in curly braces at the end of the show folder, e.g. The Office (2005) {tmdb-2316} or Sherlock (2010) {tvdb-176941}. Plex's TV Series agent uses the ID directly and skips title-based guessing. This is the cleanest fix for shows with ambiguous or duplicate titles, reboots, and international variants that share an English-language name.
Use a batch tool. UniFab TV Show Converter renames files to Plex's pattern while also standardizing container and codec. FileBot and TinyMediaManager are well-known alternatives for name-only workflows. Point the tool at your TV root, pick the Plex naming preset, preview the changes, and apply. Always keep a backup of the original filenames until Plex confirms every episode matches.
Place extras in the show folder (not a season folder) using Plex's suffix convention: Show Name (Year) - trailer.mkv, - behindthescenes.mkv, - deleted.mkv, - featurette.mkv, - interview.mkv. Alternatively, group them in subfolders named Trailers, Behind The Scenes, Deleted Scenes, Featurettes, Interviews. Plex surfaces them in the Extras tab of the show automatically after the next scan.