Plex Shows the Wrong Movie Title: Check Local Metadata
Fix Plex showing a filename or old title for the right movie. Check embedded tags, title locks and local metadata settings before refreshing one film.
Plex can find the right film and still display a title such as Harbour.Light.Export.1080p. Renaming the file may leave that text unchanged. The displayed title can come from metadata stored inside the video or from an earlier manual edit in Plex.
Start by checking whether the film's identity is wrong or only its displayed name. That choice determines whether to fix the match, edit one field, or change a library preference.
This guide covers a movie library using the current Plex Movie agent. The steps follow Plex's linked documentation; testing one item before widening the change is our recommendation.
Check the film before changing the title
Open the affected movie in Plex Web. Compare its year, plot and cast with the film you actually have. Check the associated file path too, especially when several editions or copies are present.
| What you find | Start here |
|---|---|
| Plot and cast belong to another film | Follow the wrong-match guide. |
| Correct film, but the title contains export text or an old name | Check the title lock and local metadata below. |
| Correct film with a valid title in another language | Check library language and Use original titles before blaming embedded tags. |
| Correct title, but unexpected alphabetical placement | Review Sort Title separately from Title. |
Plex documents the original-title preference in its Plex Movie settings. A language choice is different from a failed match.
Before editing, record the current Title, Sort Title, lock states, agent and local metadata preference. Keep a copy of any custom summary you care about. A metadata refresh can update more than the title.
Choose a one-film edit or a library rule
For one deliberate exception, edit the title in Plex. In Plex Web, open the movie's pencil-shaped Edit control, change Title, then save. A manually changed field becomes locked, so later metadata refreshes leave it alone. Other Plex apps may expose this through More → Manage. Plex's Edit Details guide shows the controls and lock indicators.
Our recommendation: use this route for a custom title you want to keep. Its tradeoff is ongoing ownership of that text. The lock prevents future provider corrections from replacing it too.
If many films show unwanted embedded text, consider a library rule instead. First check Manage Library → Edit → Advanced and confirm the agent is Plex Movie. Older agents and custom NFO setups use different controls.
The two similar-looking settings serve different purposes:
- Prefer local metadata gives embedded tags and local metadata priority when available.
- Use local assets allows local posters and artwork to be used.
Plex explicitly separates these choices in its movie-agent upgrade guide. You can keep local artwork while using online descriptive metadata.
Our recommendation: turn off Prefer local metadata when online movie metadata is what you want and your embedded tags are unreliable. Keep it on when you intentionally maintain those tags. This is a library-wide choice, so existing custom tagging is a reason to pause before changing it.
Refresh one movie and check the result
For the library-rule route:
- Record the current setting, turn off Prefer local metadata, and save the library settings. Leave the artwork preference as you intended it.
- Open the affected movie's editor. If Title is locked and you want Plex to replace it, unlock that field and save. Leave unrelated locks in place.
- Use the movie's ⋯ → Refresh Metadata action. Wait for it to finish, then leave the page and reopen the movie.
Plex distinguishes a scan from a metadata refresh: scanning finds new or changed files; refreshing gathers metadata again for an existing item. After an agent-setting change, use the refresh action. Repeated scans alone are a poor test of the new rule.
Check the title, year, plot and selected artwork together. Then check the movie in your usual player. If Plex Web is right but the player still shows the old title, reopen that item there before making another server change.
If the title stays wrong, stop at this film. Recheck the saved setting, the Title lock and the agent. If the plot or cast is also wrong, return to matching. Do not rename a whole folder tree to solve an unconfirmed text-field problem.
Worked example: a clean filename with an old title tag
This fictional example assumes the film has already matched correctly. It illustrates the decision, not a hands-on Plex test.
File on disk:
Movies/Harbour Light (2021)/Harbour Light (2021).mp4
Embedded Title tag:
Harbour.Light.Export.1080p
Plex details:
Title: Harbour.Light.Export.1080p
Year, plot and cast: the correct filmThe filename already follows a useful pattern. The unwanted text is inside the MP4, so changing the filename alone does not remove it. Plex documents embedded MP4 metadata as a local metadata source in its agent documentation.
Suppose this library should use online movie titles. Record the existing state, disable the local metadata preference, unlock Title if needed, and refresh this movie. The expected result is Harbour Light, with the same film and file still attached.
Treat the example as successful only after checking the result. The original file path should remain unchanged, the movie should still play, and any local poster you intended to keep should still be selected. If a second refresh restores the bad text, the source or lock choice still needs investigation.
If this were a custom title you wanted to retain, the better choice would be the one-film edit. Keeping a deliberate exception is different from repairing a library full of accidental export labels.
Undo the change without moving media
For a manual title edit, restore the recorded text and its original lock state, then save. If you want future provider updates, leave the field unlocked; if you want to retain your own wording, keep it locked.
For a library preference change, restore the previous setting and refresh the same test movie. This restores the rule, but it does not guarantee that every field returns to its previous value: online metadata may have changed. Use your notes to restore any custom text you need.
Once the test film behaves as intended, try a few other affected films, including one with custom artwork or text. A full-library refresh is a separate decision. It can update other unlocked metadata and take time; it is unnecessary when a single manual title edit solved the problem.
Keep filenames, NFO files and embedded tags separate
A filename, an NFO beside the video and a tag inside an MP4 are three different places to store information. A change in one does not automatically rewrite the others.
If your library uses Plex NFO Movie, follow Plex's NFO setup and limits. Those agents require Media Server 1.43.1 or newer. Custom agent configurations can also give embedded MP4 metadata priority over NFO data. Switching agents is a broader library decision than fixing one title.
MetaTana can help review titles, years and provider IDs and prepare filenames, NFO files and artwork. Its Plex preset selects naming and file-output formats; it does not change this Plex library preference. An NFO write is not an embedded MP4 tag rewrite.
For wider cleanup, start with one folder in MetaTana, keep renames on Ask first or Never, and review what will be written. Check metadata editing and NFO and artwork before applying changes. For this title-only problem, the Plex steps above may be all you need.
See the MetaTana Plex guide for library cleanup, or download MetaTana when you are ready to review your files.