Force Refresh Plex: Fix Stale Libraries & Buffering
Force refreshing Plex forces the server to rescan your media folders and re-fetch metadata, which fixes stuck libraries, wrong posters, missing episodes, and stale playback info. You can trigger it from the Plex Web dashboard or by touching a file in the library folder. This article explains when a force refresh is needed, how to do it correctly, and what to do when a normal refresh isn’t enough.
What a Force Refresh Actually Does
Plex normally watches your media folders and updates its database automatically when files are added, removed, or renamed. A force refresh (also called “Scan Library Files� or “Refresh All Metadata�) tells the server to ignore its cached state and re-examine every file in a library from scratch. It does two things:
- Rescans the file system – picks up new files, detects deleted ones, and updates file paths.
- Refetches metadata – re-downloads posters, descriptions, ratings, and episode info from online agents (like TheTVDB, TMDB, or your custom agents).
This is different from a regular “Scan Library Files,� which only checks for changes since the last scan. A force refresh is more thorough but takes much longer, especially for large libraries.
When You Should Force Refresh
You don’t need to force refresh regularly. The automatic scanner handles most day-to-day changes. But you should force refresh when you see these specific problems:
- New episodes or movies don’t appear even after waiting several minutes.
- Metadata is wrong or missing – incorrect titles, no poster, wrong episode descriptions.
- Files were moved or renamed outside of Plex, and the old entries still show “unavailable.�
- You changed an agent or metadata setting and want it applied to existing items.
- Playback gets stuck on “buffering� for files that used to play fine, often after a server update.
- Duplicate entries appear after file changes, or items point to the wrong file path.
If you’re experiencing none of these, a force refresh won’t improve anything and will only waste CPU and network bandwidth.
How to Force Refresh on Different Platforms
The steps vary slightly depending on where you run your Plex server.
Plex Web (Most Common)
- Open Plex Web (app.plex.tv or your local server address) and sign in.
- Go to your library (e.g., “Movies� or “TV Shows�).
- Click the three-dot menu (⋯) next to the library name at the top.
- Choose Scan Library Files – this is a regular scan. To force a full metadata refresh, you need to go deeper.
- For a true force refresh, click the three-dot menu again, then select Manage Library → Refresh All Metadata.
Note: “Refresh All Metadata� will re-download all metadata for every item in that library. It can take hours for large libraries and may hit rate limits on metadata providers.
Plex Media Server on Windows, macOS, Linux, or NAS
- Open the Plex Web interface for your server.
- Go to Settings → Libraries.
- Click the three-dot menu next to the library you want to refresh.
- Choose Scan Library Files for a quick rescan, or Refresh All Metadata for a full force refresh.
Alternatively, you can trigger a scan from the command line by touching a file in the library folder (e.g., touch /path/to/library/movie.mkv on Linux/macOS). Plex detects the file system change and scans just that folder—this is a lighter way to force a refresh for a single item.
Force Refresh vs. Regular Scan vs. Optimized Versions
Many users confuse “force refresh� with other maintenance tasks. Here’s a quick comparison:
- Regular Scan (“Scan Library Files�) – Checks for new, changed, or deleted files. It does not re-download metadata for existing items unless they’re new.
- Force Refresh (“Refresh All Metadata�) – Rescans everything AND re-downloads all metadata. Use this when metadata is wrong or missing.
- Optimized Versions – These are pre-transcoded copies for specific devices. They are not affected by a force refresh; you must delete and recreate them separately.
- Empty Trash – Removes entries for files that no longer exist. A force refresh does not automatically empty the trash; you may need to do both.
Common Problems After a Force Refresh
Sometimes a force refresh introduces new issues. Here’s what to expect and how to handle it:
- Metadata temporarily disappears – During the refresh, items may show blank posters or “No Title� until the agent responds. Wait a few minutes.
- Rate limiting – If you have a huge library, TheTVDB or TMDB may throttle your requests. This can cause metadata to fail. Wait a few hours and run “Refresh All Metadata� again, or refresh only the affected items.
- Custom posters are lost – If you manually set a poster, a force refresh may overwrite it. To prevent this, lock the poster by clicking the pencil icon on the item and toggling the lock.
- Server performance drops – A full refresh is CPU and disk intensive. If you have a low-powered NAS, the server may become unresponsive during the scan. Schedule it during off-peak hours.
How to Force Refresh a Single Item Instead of the Whole Library
Refreshing an entire library is overkill if only one movie or show is broken. To force refresh a single item:
- Open the item’s detail page in Plex Web.
- Click the three-dot menu (⋯) on the item.
- Select Refresh Metadata (or “Refresh� on some versions).
- Plex will re-fetch metadata for that item only.
This is the fastest fix for a single wrong poster or missing episode. It also avoids rate limits.
When Force Refresh Doesn’t Fix the Problem
If a force refresh doesn’t resolve your issue, the problem is likely not with the metadata cache but with the file structure or the server itself. Try these steps in order:
- Check file permissions – Ensure the Plex server has read access to the media folder. On Linux, check ownership and chmod.
- Verify the file is not corrupt – Play the file with a media player like VLC. If it won’t play, Plex can’t scan it properly.
- Check the Plex Media Server logs – Look for errors about “Unable to scan� or “Unavailable.� Logs are in the Plex data directory.
- Restart the Plex Media Server – Sometimes the database gets locked. A restart clears locks.
- Optimize the database – In Plex Web, go to Settings → Troubleshooting → Optimize Database. This can fix corruption.
- Move the file to a new folder – If Plex still won’t pick it up, copy the file to a different directory and rescan. This often forces a fresh entry.
Frequently Asked Questions
Does force refresh delete my custom posters or ratings?
Yes, unless you lock them. When you refresh metadata, Plex overwrites all fields that are not locked. To keep custom posters or descriptions, click the pencil icon on the item, then click the lock icon next to the field you want to preserve. Locked fields are not touched by a refresh.
How long does a force refresh take?
It depends on library size and internet speed. A small library (under 100 items) may take a few minutes. A library with thousands of items can take several hours, especially if metadata agents are slow. You can monitor progress in the Plex Web dashboard under “Activities.�
Will force refresh fix buffering or playback issues?
Sometimes. If buffering is caused by corrupted metadata or a stale file path, a refresh can help. But buffering is more often due to network issues, transcoding limitations, or the client device. Check your server’s CPU usage during playback and try direct play instead of transcoding.
Can I force refresh from the Plex mobile app?
Yes, but with limitations. In the Plex mobile app, you can go to your library, tap the three dots, and select “Scan Library Files.� The “Refresh All Metadata� option is not available in the mobile app—you must use Plex Web or the server settings. For individual items, you can tap the three dots on the item and select “Refresh Metadata.�
Does force refresh affect multiple users on my server?
Yes. A force refresh updates the shared library, so all users with access to that library will see the changes. It may temporarily slow down the server for everyone during the scan. If you have many concurrent users, consider doing the refresh during low-usage hours.
What is the difference between “Scan Library Files� and “Refresh All Metadata�?
“Scan Library Files� only checks the file system for changes—new files, deleted files, and renames. It does not re-download metadata for existing items. “Refresh All Metadata� does a full rescan and also re-fetches all metadata from online agents. Use the former for routine updates, the latter for fixing broken metadata.
Related
Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.