If your Plex guide not updating metadata is leaving you with blank posters, missing episode descriptions, or outdated program information, this guide walks you through the causes and fixes. It applies whether you are dealing with a library that refuses to pull fresh artwork and summaries, or a Live TV guide that will not show current program data.
Table of Contents
Why Plex guide metadata stops updating
Plex relies on online metadata agents and, for Live TV, an electronic program guide (EPG) feed, to fill in artwork, summaries, cast details, and schedules. When this data stops refreshing, it is usually down to one of a handful of issues: a lost connection to Plex’s online services, an incorrect or conflicting metadata agent, corrupted local metadata files, incorrect file naming that confuses the matching process, or a server that simply has not been told to look for updates. Live TV guide problems often come down to tuner or lineup configuration rather than the server itself.
What you’ll need
- Access to your Plex Media Server, either locally or via remote access
- Admin rights on the Plex account managing the server
- A stable internet connection on the machine running Plex
- Media files named in a way Plex can recognise (this matters more than people expect)
Step 1: Confirm the server can reach the internet
- Open the Plex web app and check that your server shows as online rather than in a limited or offline state.
- Test the internet connection on the machine hosting Plex, since metadata and guide data are both pulled from online sources.
- If you use a firewall, router-level content filtering, or a VPN on the server, temporarily disable it to rule out blocked connections to Plex’s metadata services.
Step 2: Refresh metadata manually
- Go to the library that is showing stale or missing information.
- Select the three-dot menu on the library and choose the option to refresh all metadata.
- For a single item, open it, click the three-dot menu on that title, and choose to refresh metadata just for that item.
- Allow time for the process to complete, especially on large libraries, since Plex works through items in a queue rather than instantly.
This manual trigger is often the fastest fix, and it is worth trying before making any deeper changes. If you have recently added new files, it also helps to refresh your Plex library after adding content so Plex knows to scan for both new media and updated details.
Step 3: Check your metadata agent settings
- Open the library’s settings and look at which metadata agent is assigned to it.
- Make sure the agent matches the content type, since a movie library pointed at a TV-focused agent (or vice versa) will struggle to pull correct data.
- If you have changed agents recently, run a full metadata refresh again so Plex re-queries the correct source.
Step 4: Review file and folder naming
Plex matches your files against online databases using the names and folder structure you give them. If a show or movie is named inconsistently, missing a year, or structured incorrectly, Plex may either fail to match it or match it to the wrong title, which shows up as metadata that never seems to update correctly. Reviewing how to name your files correctly for Plex recognition resolves a large share of these mismatches, particularly for TV libraries with multiple seasons.
Step 5: Clear cached local metadata for a stubborn item
- For an individual title that will not update no matter how many refreshes you run, remove the local match and let Plex search again.
- Open the item, use the option to fix its match, and search for the correct title manually if the automatic match is wrong.
- Confirm the correct match and allow Plex to pull fresh metadata for that item specifically.
Step 6: Restart Plex Media Server
- Fully stop and restart the Plex Media Server application or service, rather than just closing the app window.
- Reopen Plex and check whether metadata updates begin flowing again once the server has restarted its background processes.
A restart clears temporary glitches in the scanning and metadata queue that a simple refresh sometimes cannot fix.
Fixing the Live TV guide specifically
If the problem is with the Live TV program guide rather than your movie or show library, the cause is usually different. The guide data comes from your tuner’s lineup or an EPG source tied to your region and provider, not from the same metadata agents used for personal media.
- Check your DVR settings and confirm the correct TV provider or lineup is still selected.
- Verify your tuner hardware is detected and reporting channels correctly.
- Remove and re-add the guide source if channel data looks outdated, since this forces Plex to pull a fresh schedule.
- Confirm your account status is current, since Live TV and DVR features depend on an active subscription tier.
Tips and troubleshooting
- Large libraries take time to refresh fully, so give the process a reasonable window before assuming it has failed.
- Avoid running multiple manual refreshes back to back, as this can queue redundant jobs and slow the whole process down.
- Keep Plex Media Server updated, since older versions can lose compatibility with current metadata agent APIs.
- If only one library is affected, the issue is likely agent or naming related; if every library and the guide are affected, focus on network and account connectivity first.
- Signing out of your Plex account on the server and signing back in can resolve authentication issues that quietly block metadata requests.
Frequently asked questions
Why does Plex keep pulling the wrong metadata for a show?
This usually comes down to file or folder naming that does not clearly match the correct title and year. Fixing the match manually and correcting the naming convention prevents it from reverting on the next refresh.
How often does Plex automatically refresh metadata?
Plex periodically checks for updates in the background, but the interval is not something you can rely on for immediate changes. A manual refresh is the reliable way to force an update when you need it right away.
Does a poor internet connection affect metadata updates?
Yes. Since metadata and guide data are pulled from online sources, an unstable or blocked connection on the server prevents Plex from retrieving updated information, even if playback itself works fine locally.
Can outdated Plex Media Server software cause this issue?
Yes, running an older version can break compatibility with current metadata services. Keeping the server updated, alongside checking your Plex server for other common issues, helps avoid a range of related problems beyond just metadata.




