You finish a movie, but Plex still shows it as unwatched. Or you’re halfway through a series and the “Continue Watching” row disappears. Or On Deck shows episodes you watched weeks ago. These are some of the most common — and most frustrating — Plex issues we handle, because watch tracking affects every part of the experience.
Understanding how Plex actually tracks watch status makes these problems much easier to diagnose. Here’s the full picture.
How Plex Tracks Watched Status
Plex uses two layers of watch tracking that work together:
- Local server database: Your Plex Media Server stores a per-user record of every item’s watch state — unwatched, in progress (with a resume timestamp), or watched. This is the primary source of truth for your server.
- Plex account sync: If users are signed into their Plex accounts (not managed/home users without accounts), watch history syncs to Plex’s cloud. This lets watched status carry across multiple servers — if you watch a movie on Server A, it shows as watched on Server B too (if both have the same content).
The threshold for “watched” is roughly 90% completion. If you stop at 85%, the item stays “in progress.” If you watch past 90%, Plex marks it as fully watched and removes it from Continue Watching. Fast-forwarding to the end also triggers the watched flag.
On Deck vs Continue Watching vs Recently Added
These three rows look similar but have different logic:
- On Deck — for TV shows. Shows the next unwatched episode of shows you’re actively watching. A show appears here when you’ve watched at least one episode but haven’t finished the series. It disappears when you finish the last episode or haven’t watched an episode in a while.
- Continue Watching — for partially watched items. If you stopped a movie at the 45-minute mark, it shows here with a progress bar. Same for TV episodes you paused mid-way. Completing the item removes it.
- Recently Added — purely chronological. Shows the most recently scanned items regardless of watch status. This one rarely breaks.
Common Problems and Fixes
Items won’t mark as watched
You watched the whole thing but it still shows the unwatched dot:
- Client didn’t report completion. Some clients (especially web browsers) fail to send the “scrobble” event if you close the tab before the credits finish. Fix: manually mark as watched (three dots → Mark as Played).
- Network interruption. If the client lost connection to the server during playback, the watch event may not have been recorded. The server needs to receive the completion signal.
- Managed user sync issues. Managed users (home users without their own Plex account) have watch history stored only on the local server. If the server database has issues, their history can be affected without cloud backup.
On Deck shows wrong episodes or stale content
- Episode ordering mismatch. If your files are ordered differently than Plex’s metadata (air date vs DVD order), On Deck may pick the wrong “next” episode. Check the show’s settings → Advanced → Episode ordering.
- Specials confusing the sequence. Season 0 (Specials) episodes can throw off On Deck. If a special is between seasons and you haven’t watched it, On Deck may point there instead of the next regular episode.
- Stale entries. Sometimes On Deck holds onto shows you finished or abandoned. Clear a specific item: three dots → Mark as Played on the stuck episode, or “Remove from Continue Watching.”
Continue Watching shows content you finished
Usually means the item hit 85-89% — close to the threshold but not past it. Credits rolled, you stopped, but Plex didn’t count it. Fix: mark as played manually. For shows where credits run long over a preview of the next episode, this happens often.
Watched status not syncing between devices
- Same server, different clients: This should always work. If it doesn’t, the client that played the content may not have sent the scrobble. Check Tautulli (see below) to see if the play session was recorded at all.
- Different servers: Requires both users to have Plex accounts (not managed users) and both servers to have the same content matched to the same metadata. If Server A has “The Matrix (1999)” and Server B has it filed as a different edition or year, sync won’t match them.
Tautulli: Detailed Watch History
Plex’s built-in history is limited — it shows recent plays but doesn’t give you detailed analytics. Tautulli (formerly PlexPy) is a free companion tool that logs every play session with timestamps, duration, user info, client device, quality, and whether the session was transcoded or direct played.
Why Tautulli matters for watch history troubleshooting:
- See if a play session was actually recorded (if Tautulli doesn’t show it, the server never received the scrobble)
- Check whether a user watched 100% or stopped at 87%
- Identify client-specific issues (e.g., Roku app consistently not reporting completion)
- Export full watch history for backup
Managed Users vs Plex Accounts
This distinction matters more than most people realize:
- Managed users (Home users created by the server owner) have watch history stored only on the local server. No cloud sync. If you rebuild your Plex server, managed user watch history is gone unless you backed up the database.
- Plex account users (friends you shared with, or home members who signed in with their own Plex account) get cloud-synced watch history. Their watched status survives server rebuilds and works across multiple servers.
For families: create Plex accounts for each family member rather than managed users if you want their history to persist. Managed users are simpler to set up but less durable.
Rebuilding or Resetting Watch History
When the database is genuinely corrupted — mass items showing wrong status, On Deck completely broken — sometimes a targeted reset is necessary:
- Single item: Three dots → Mark as Played/Unplayed. Quick and surgical.
- Entire library: Library settings → Manage Library → you can reset all watched status for a library. This is destructive — everyone’s history for that library resets.
- Database repair: Plex has a built-in database repair tool (Settings → Troubleshooting → Repair Database). This can fix corrupted watch records without erasing everything.
- Optimize database: Settings → Scheduled Tasks → Optimize Database. Cleans up orphaned records and can fix stale On Deck entries.
Before doing anything destructive, back up your Plex database. The database file (com.plexapp.plugins.library.db) lives in your Plex data directory and contains all metadata, watch history, and user preferences. Copy it somewhere safe first.
Preventing Watch History Issues
- Don’t close the client mid-credits. Wait a few seconds after the movie ends before closing. Some clients need that moment to send the completion event.
- Keep clients updated. Older Plex clients have worse scrobble reliability.
- Use Plex accounts over managed users for cloud-synced watch history.
- Run database optimization weekly. Schedule it during off-hours in Plex’s scheduled tasks settings.
- Install Tautulli as a safety net. Even if Plex loses a watch record, Tautulli has the log.
Plex acting up?
Our techs fix watch history, On Deck, and sync issues in a single session. Flat rate, no fix no charge.
Book a Fix →