Plex Metadata Wrong? How to Fix Incorrect Matches

You scan your library and discover that Plex has matched your copy of "The Office" to a completely different show. Or a movie has the wrong poster, wrong year, wrong plot description. Incorrect metadata matching is a common annoyance, but it is almost always fixable. This guide covers how to correct wrong matches, prevent them from happening in the first place, and understand why Plex sometimes gets confused.

Why Plex Gets Matches Wrong

Plex identifies your media by extracting a title and year from the file and folder names, then searching online databases for a match. The process sounds simple, but several factors can trip it up.

Ambiguous titles. Dozens of films share the same or similar titles. "Crash" could be the 2004 ensemble drama, the 1996 Cronenberg film, or several others. Without a year to disambiguate, Plex picks the most popular match, which may not be the one you have.

Non-standard file names. If your files use abbreviations, shorthand, release group tags, or codec information in place of the actual title, Plex cannot parse them correctly. A file named LOTR.EE.2003.BluRay.x264.mkv gives Plex very little to work with compared to The Lord of the Rings - The Return of the King (2003).mkv.

Wrong content type. If your library is configured as a "Movies" library but contains TV show episodes (or vice versa), the scanner will try to match files against the wrong database entirely. A TV episode matched as a movie will inevitably get incorrect metadata.

Regional variations. Some content is known by different titles in different countries. The metadata databases may list the title you used as an alternate title for a different film in another language, causing a cross-match.

Using Fix Match

The Fix Match feature is your primary tool for correcting wrong matches. Navigate to the incorrectly matched item in your Plex library, click the three-dot menu (or right-click), and select Fix Match.

A search dialog appears where you can type the correct title and year. Plex will show results from its metadata agent (typically TheMovieDB for movies or TheTVDB for shows). Select the correct match from the results.

Using Database IDs for Precision

When the title search returns too many results or the correct match is buried, you can search by the exact database ID. Go to TheMovieDB (themoviedb.org) or TheTVDB (thetvdb.com) and find your content. Note the numerical ID from the URL. In the Fix Match search box, enter the ID as:

tmdb://12345 for TheMovieDB movie IDs
tvdb://67890 for TheTVDB series IDs
imdb://tt1234567 for IMDb IDs

Using a database ID guarantees an exact match with no ambiguity. This is especially useful for obscure titles, foreign-language content, or items with very common names.

Manual Search and Selection

For more control, you can manually edit an item's metadata. Click on the item, select the three-dot menu, and choose Edit. The edit dialog lets you change the title, year, tagline, content rating, studio, and other fields. You can also upload a custom poster and background image.

Manual edits override the metadata agent's data. If Plex re-scans or refreshes the item later, your manual edits should be preserved (they are "locked" by default when you edit manually). However, an Unmatch-and-Rematch operation will overwrite manual edits, so be cautious.

Metadata Agents and Priority

Plex uses metadata agents to fetch information from online databases. The agent determines which database is used for matching and what metadata is pulled. Understanding the agent stack helps you control matching behavior.

Navigate to Settings > Agents to see and configure the agent priority for each library type. For movies, TheMovieDB is the default primary agent. For TV shows, TheTVDB is the default. You can reorder agents to change which database takes priority, add secondary agents for supplemental data (like Rotten Tomatoes ratings), or disable agents you do not want.

The Plex Movie and Plex TV Series agents (sometimes called the "New Plex Agents") combine multiple data sources automatically and are generally more accurate than the legacy agents. If you are still using the older agents (labeled "Freebase" or individual database names), consider switching to the new Plex agents for better matching.

TMDB, TVDB, and MusicBrainz

TheMovieDB (TMDB) is the primary database for movies. It has excellent coverage of mainstream and international films, with user-contributed data that is regularly updated. If a movie exists, TMDB almost certainly has an entry for it.

TheTVDB (TVDB) is the primary database for TV shows. It covers an enormous range of series from around the world. However, TVDB has undergone changes in recent years that have affected some data accuracy, leading some users to prefer TMDB for TV matching as well (TMDB also maintains TV show data).

MusicBrainz is the primary database for music. It relies on acoustic fingerprinting and user-contributed metadata. Music matching is inherently more challenging due to the vast number of releases, remasters, and re-issues that share similar titles.

File Naming Best Practices

The single most effective way to prevent incorrect matches is to name your files correctly before scanning. Follow these conventions consistently.

Movies: /Movies/Title (Year)/Title (Year).ext. Example: /Movies/Blade Runner (1982)/Blade Runner (1982).mkv. Always include the year. Always use the official English title as listed on TMDB (or the title in your preferred language if your agent is configured accordingly).

TV Shows: /TV Shows/Show Name/Season XX/Show Name - SXXEXX - Episode Title.ext. Example: /TV Shows/The Expanse/Season 03/The Expanse - S03E01 - Fight or Flight.mkv. The episode title is optional but helps with verification. The SXXEXX pattern is required.

Edition tags: If you have multiple versions of the same movie (theatrical, director's cut, extended, 4K), use Plex's edition tag syntax: Movie Title (Year) {edition-Director's Cut}.mkv. This tells Plex these are different editions of the same movie, not different movies.

Year in the filename: Cannot be overstated. The year is the single most important disambiguation tool. "Dune (1984)" and "Dune (2021)" are completely different films. Without the year, Plex will match to whichever is more popular at the time of scanning, which changes over time.

Preventing Future Mismatches

Beyond file naming, these practices reduce the chances of incorrect matches. Keep different media types in separate libraries (do not mix movies and TV shows). Avoid putting unrelated files (samples, extras, trailers) in the same folder as your main media unless they follow Plex's naming conventions for extras. Run manual scans after adding new content rather than relying solely on automatic scanning, so you can catch mismatches immediately.

After scanning new content, browse through the recently added items to spot-check the matches. A few seconds of verification when adding content prevents the frustration of discovering a mismatch weeks later when you sit down to watch.

For large libraries or initial imports, consider using a tool like FileBot or Tiny Media Manager to bulk-rename your files according to Plex's conventions before scanning. These tools look up each file against TMDB or TVDB and rename them to the correct format automatically, dramatically reducing mismatches on the initial scan.

Related Articles