How to Optimize Your Plex Library Metadata

You’ve got hundreds of movies and TV shows in Plex, but half of them have wrong posters, missing descriptions, or are matched to the wrong title entirely. “The Office” is showing up as a 1995 British show. Your 4K rip of Dune is displaying a fan-made poster. Season 3 of a show has no episode thumbnails.

Metadata problems are one of the most common Plex frustrations. This guide covers how Plex metadata actually works and how to fix it properly.

How Plex Metadata Works

When you add media to Plex, three things happen in sequence:

1. Scanning: Plex finds files on disk and parses their names to identify what they are
2. Matching: Plex matches each item against an online database (TMDb, TVDB, etc.)
3. Fetching: Plex downloads metadata (title, description, poster, cast, ratings) from the matched entry

Problems at any stage cascade. A bad file name causes a bad match, which pulls completely wrong metadata.

Step 1: Fix Your File Naming

This is the foundation. If your files aren’t named correctly, everything else breaks. Plex is strict about naming conventions:

Movies

Format: /Movies/Movie Name (Year)/Movie Name (Year).mkv

• /Movies/Inception (2010)/Inception (2010).mkv — correct
• /Movies/inception.2010.1080p.BluRay.x264.mkv — often works but risky
• /Movies/Inception/Inception.mkv — missing year, may mismatch

The year is critical for disambiguation. “Dune” could be 1984 or 2021. “The Office” could be US or UK.

TV Shows

Format: /TV Shows/Show Name (Year)/Season 01/Show Name - S01E01 - Episode Title.mkv

• Season folders are strongly recommended
• The S01E01 format is the most reliable
• Multi-episode files: S01E01-E02 or S01E01E02

Bulk Renaming Tools

Don’t rename thousands of files by hand. Use:

• FileBot — the gold standard for media file renaming ($6 license, worth it)
• Sonarr / Radarr — auto-rename on download
• ReNamer — free, regex-based bulk renamer

Step 2: Choose the Right Metadata Agent

Plex uses “agents” to fetch metadata. The agent you choose affects matching accuracy and what metadata is available.

For Movies

• Plex Movie: The default. Uses TMDb data. Good for most content. Automatically creates franchise collections.
• Personal Media: For home videos and personal content. Reads metadata from the file and folder names only.

For TV Shows

• Plex TV Series: The default. Uses TMDb and TVDB. Generally the best choice.
• TheTVDB: Legacy agent. Some users prefer it for anime or shows not well-covered by TMDb.

Changing Agents

Library → Manage Library → Edit → Advanced → Agent. Note: changing agents on an existing library can require a full metadata refresh.

Step 3: Fix Mismatched Items

When Plex matches a movie or show to the wrong entry, you can fix it manually:

1. Click on the mismatched item
2. Click the three dots (...) or “Fix Match”
3. Search for the correct title manually
4. Select the right match from the results
5. Plex will re-fetch all metadata for that item

For items that won’t match at all, try using the TMDb or TVDB ID directly. Click “Search Options” and enter the ID from the database website.

Step 4: Customize Posters and Artwork

Changing Posters in Plex

Click on any item → Edit → Poster. Plex shows available posters from its metadata sources. You can also:

• Upload a custom poster image
• Enter a URL to a poster image
• Use local poster files (name them poster.jpg in the movie’s folder)

Where to Find Good Posters

• ThePosterDB — curated, consistent poster sets. The best source for matching collection art.
• Mediux — high-quality posters with Kometa integration
• Fanart.tv — community-driven artwork for movies, TV, and music

Background Art and Title Cards

Beyond posters, you can customize:

• Background art: Displayed behind the item detail view. Place background.jpg or fanart.jpg in the media folder.
• Episode title cards: Custom thumbnails for individual episodes. Huge time investment but makes a library look incredible.

Step 5: Metadata Refresh vs Full Scan

People confuse these:

• Scan Library Files: Looks for new/changed/removed files. Doesn’t re-fetch metadata.
• Refresh Metadata: Re-downloads metadata for items that are already matched. Won’t fix a bad match.
• Analyze: Reads file properties (resolution, audio codecs, bitrate). Useful if media info is showing wrong.

For a mismatched item, you need “Fix Match” first, then optionally “Refresh Metadata” to pull updated info.

Automating Metadata with Kometa

Kometa (formerly Plex Meta Manager) automates metadata management at scale:

• Apply poster sets across entire libraries or collections
• Add overlays (4K, HDR, Dolby Atmos badges) to posters automatically
• Sync ratings from IMDb, TMDb, Trakt, Letterboxd
• Create and maintain smart collections based on external lists
• Schedule daily/weekly metadata updates

If you have a large library (500+ items), Kometa saves massive amounts of manual work and keeps everything consistent.

Common Metadata Problems and Quick Fixes

• Wrong movie matched: Fix Match → search by title + year or TMDb ID
• Missing episode thumbnails: Refresh Metadata on the show. If still missing, the source database doesn’t have them.
• Duplicate entries: Usually means two copies of the same file with slightly different names. Merge them or delete the duplicate.
• Genre/rating missing: Check that your agent is configured to pull from the right source. Refresh metadata.
• “Unmatched” items: Fix file naming first, then try Fix Match manually.
• Metadata locked: If you manually edited metadata, Plex locks it to prevent overwriting. Unlock via Edit → uncheck the lock icon on each field.