Plex Not Finding Your Media? Fix Scan and Match Issues

You have added new files to your media folder, but Plex stubbornly refuses to show them. Or worse, it found the files but matched them to the wrong movie, wrong show, or wrong album entirely. Library scanning and matching issues are among the most common Plex frustrations, and they almost always come down to how your files are named and organized.

Why Plex Cannot Find Your Files

Plex relies on a combination of file naming conventions, folder structure, and metadata agents to identify and catalog your media. When any of these elements are wrong, the scanner either skips files entirely or matches them incorrectly. The scanner is not reading the content of your files. It is reading your folder names, file names, and sometimes embedded metadata tags to figure out what each file is.

Understanding this distinction is key. Plex does not know that a file named movie.mkv sitting in a folder called Downloads is actually "The Shawshank Redemption." It needs you to tell it, through proper naming.

File Naming Conventions That Work

Movies

Every movie should be in its own folder, and both the folder and file should include the movie title and release year. The correct format is:

/Movies/The Shawshank Redemption (1994)/The Shawshank Redemption (1994).mkv

The year in parentheses is critical. Without it, Plex may match your file to a different movie with the same or similar title. There are multiple films called "Crash," "Frozen," and "The Thing." The year disambiguates them.

Common mistakes that cause scan failures: putting multiple movies in one folder, omitting the year, using abbreviations or shorthand in the file name, including extraneous information like resolution or codec in the primary file name (these belong in curly braces as edition tags, e.g., {edition-4K HDR}), and using periods or underscores instead of spaces.

TV Shows

TV shows require a nested folder structure: show name, then season folders, then episode files with season and episode numbers. The format Plex expects is:

/TV Shows/Breaking Bad/Season 01/Breaking Bad - S01E01 - Pilot.mkv

The S01E01 pattern (season number, episode number, zero-padded) is the most reliable format. Plex also recognizes 1x01 format, but S01E01 is preferred. Without this pattern, Plex cannot determine which season and episode a file belongs to, and it will either skip the file or guess incorrectly.

Music

Music follows the structure: /Music/Artist/Album/01 - Track Title.flac. Plex uses embedded ID3 tags (for MP3) or Vorbis comments (for FLAC) in addition to file names. If your tags are incorrect or missing, use a tool like MusicBrainz Picard to retag your collection before scanning.

Photos

Photos are organized by date, ideally in a /Photos/YYYY/MM-MonthName/ structure. Plex reads EXIF data from photos to determine dates and locations. Files without EXIF data will still appear but may be sorted incorrectly.

Scanners and Agents

Plex uses two components when processing your library. The scanner finds files on disk and determines their basic identity (movie title, show name, episode number). The agent fetches metadata (posters, descriptions, ratings, cast information) from online databases.

For movies, the default agent pulls from TheMovieDB (TMDB). For TV shows, it uses TheTVDB (TVDB). For music, it uses MusicBrainz. If the agent cannot find a match for the title and year the scanner extracted from your file name, the item either goes unmatched or gets matched to something wrong.

Check your library's scanner and agent settings by going to Settings > Manage > Libraries, clicking the three-dot menu on the library, and selecting Edit. Ensure the scanner matches the content type (Plex Movie for movies, Plex TV Series for shows) and that the agent is set to a reliable source.

Forcing a Manual Scan

Plex runs periodic automatic scans, but they do not always catch new files immediately, especially if your server was offline when files were added. To force a scan, navigate to the library in the Plex web interface, click the three-dot menu, and select Scan Library Files.

If a scan does not pick up your new files, try Clean Bundles and Empty Trash from the same menu, then scan again. These operations remove stale references to deleted files that can sometimes interfere with new scans.

Fixing Incorrect Matches

When Plex matches a file to the wrong title, you can correct it manually. Click on the incorrectly matched item, select the three-dot menu, and choose Fix Match. This opens a search dialog where you can type the correct title, year, and even a TMDB or TVDB ID to find the exact match you want.

For TV shows, the fix must be applied at the show level, not individual episodes. Fix the show match first, then check whether the episodes sorted themselves correctly. If individual episodes are still wrong (perhaps because of ambiguous naming), you can manually edit episode information through Edit > Episode.

Refreshing Metadata

If a match is correct but the metadata is wrong, missing, or incomplete, use Refresh Metadata from the item's three-dot menu. This re-fetches information from the online agent without changing the match itself. You can also select Unmatch to completely disassociate an item and then re-match it from scratch.

File Permissions

On Linux and NAS systems, file permissions are a frequent cause of missing media. The Plex Media Server process runs under a specific user account (typically plex). If your media files or folders do not grant read access to that user, the scanner will skip them silently.

Check permissions by running ls -la on your media directories. The Plex user needs at minimum read and execute permission on directories and read permission on files. On a Synology NAS, ensure the plex user or group has read access to the shared folder containing your media. On an Unraid server, verify that the share permissions include the nobody user.

Common Mistakes That Prevent Scanning

Beyond naming and permissions, watch for these pitfalls. Hidden files (names starting with a dot on Unix systems) are skipped by the scanner. Files with unsupported extensions (like .nfo or .txt) are ignored. Symbolic links may or may not be followed depending on your operating system and Plex version. Network-mounted drives (NFS, SMB) can sometimes become temporarily unavailable, causing Plex to mark all content from that mount as missing. If your media appears and disappears intermittently, check the mount stability.

Finally, ensure your library is pointed at the correct root folder. If you moved your media to a new drive or changed the folder structure, update the library path in Settings > Manage > Libraries > Edit to reflect the new location.

Related Articles