How to Fix Plex & Jellyfin Metadata

Why Plex and Jellyfin Get Your Metadata Wrong

You've spent hours organizing your media library. Every file is named perfectly: Movies/The Batman (2022)/The Batman (2022).mkv. You run a Plex scan, and... it matches to a 1943 Turkish film called "Batman" with a grainy black-and-white poster.

Or worse: your Plex dashboard stubbornly displays "Spiderman.2002.720p.BRRip.x264.YIFY" as the title, even though you renamed the file weeks ago.

These aren't Plex bugs — they're the natural consequence of how media servers prioritize metadata from different sources. Understanding this priority hierarchy is the key to fixing every matching issue.

The Metadata Priority Hierarchy

Plex (and Jellyfin/Emby) trust data sources in this specific order:

1. Embedded metadata (tags inside the file) — Read first, trusted most if "Prefer Local Metadata" is enabled
2. File and folder names — Parsed for the media title, year, season, and episode numbers
3. Online databases (TMDB, TVDB, MusicBrainz) — Queried using the parsed title + year as a search term
4. User overrides — Manual edits in the Plex/Jellyfin UI (stored in the server database, not the file)

The "Bad Title" bug occurs at layer 1: your MP4 file has a junk Title atom (often left over from the encoding tool) that Plex reads before it even looks at your carefully crafted filename.

The "Bad Title" Bug — Full Technical Explanation

When you download or rip an MP4 file, the encoding software often writes its own string into the ©nam (Title) atom:

Title: Spiderman.2002.720p.BRRip.x264-YIFY

Or from OBS/screen recorders:

Title: obs-output-2026-01-15
Comment: Recorded with OBS Studio v30.2.1

When Plex scans this file, it reads the embedded Title atom first. If "Prefer Local Metadata" is enabled (or if the embedded title is the only title available), Plex displays this junk string instead of querying TMDB for the real movie title.

The fix requires removing or correcting the embedded Title atom. Renaming the file is not enough.

How to Fix Every Common Issue

Problem 1: Wrong Title Displayed

Cause: Junk in the ©nam (Title) or ©cmt (Comment) atoms.

Fix (ExifTool):

# Clear the Title and Comment atoms from an MP4
exiftool -Title= -Comment= movie.mp4

# Recursively clear from all MP4/MKV files in a directory  
exiftool -Title= -Comment= -overwrite_original -r -ext mp4 -ext mkv /Movies/

Fix (MKVToolNix for MKV):

# Clear MKV title tag
mkvpropedit movie.mkv --edit info --delete title

Fix (Ambedo): Drop your files into Ambedo, select all, clear the Title and Comment fields, and export. The files are remuxed locally — no re-encoding, no quality loss.

Problem 2: Wrong Movie Matched

Cause: Ambiguous title (e.g., "Emma" could match 1996, 2009, or 2020 versions).

Fix: Embed the TMDB ID directly into the filename.

Movies/Emma (1996) {tmdb-932}/Emma (1996).mkv
Movies/Emma (2020) {tmdb-556984}/Emma (2020).mkv

The {tmdb-XXXXX} tag forces Plex's agent to match against a specific TMDB entry, bypassing the fuzzy search entirely. You can find any movie's TMDB ID by searching themoviedb.org.

For TV shows, use TVDB IDs:

TV Shows/Breaking Bad (2008) {tvdb-81189}/Season 01/Breaking Bad - S01E01.mkv

Problem 3: TV Episodes Out of Order

Cause: Inconsistent naming format. Plex requires strict SxxEyy formatting.

Correct naming:

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 - Seven Thirty-Seven.mkv

Do NOT use: 1x01, E01, Episode 1, Ep01, or any variant. The scanner is strict.

Problem 4: Stuck Cache (Nothing Fixes It)

When Plex caches a wrong match and refuses to update, you need the Plex Dance:

1. Move the file OUT of the monitored library folder
2. Scan the library (Plex detects the file is gone)
3. Empty Trash in Plex settings
4. Clean Bundles in Plex settings
5. Move the file BACK into the library folder
6. Scan again (Plex treats it as a brand-new file)

This clears Plex's internal cache entry for that file, forcing a fresh match.

Problem 5: Multiple Editions (Theatrical vs Director's Cut)

Use Plex's edition tag (requires Plex Pass):

Blade Runner (1982)/
  Blade Runner (1982) {edition-Theatrical}.mkv
  Blade Runner (1982) {edition-Final Cut}.mkv
  Blade Runner (1982) {edition-Director's Cut}.mkv

Essential Tools for Media Server Metadata

| Tool | Best For | Price | |:-----|:---------|:------| | FileBot | Automated bulk renaming with TMDB/TVDB matching | $6/year | | Ambedo | Stripping junk Title/Comment atoms without installing software | Free tier available | | MKVToolNix | Deep MKV container surgery (audio/subtitle track management) | Free | | tinyMediaManager | Full movie/TV metadata management with poster scraping | Free (basic) | | ExifTool | CLI-based metadata cleaning across any format | Free |

Jellyfin-Specific Notes

Jellyfin uses the same naming conventions as Plex with minor differences:

• Jellyfin natively supports .nfo sidecar files (XML format) for overriding metadata
• Jellyfin's scanner is generally more forgiving with naming variants than Plex
• Jellyfin supports {tmdb-XXXXX} and {imdb-ttXXXXXXX} ID tags in folder names
• Emby follows similar conventions to Jellyfin (they share a common ancestry)