Plex will end TheTVDB metadata support on Dec. 3
Plex ends TheTVDB support Dec. 3. See how it affects ongoing shows, alternate episode orders, and libraries still using the legacy TVDB agent.
Plex says it will stop using TheTVDB as a television metadata source on Dec. 3. The change matters most for media libraries that rely on TheTVDB to label new episodes or assign them a particular order. Plex says existing libraries, shows and metadata will stay in place when the service changes.
The Nov. 20 announcement gives users two settings to check. A library can have one preference for episode order, and an individual show can override it. Changing the library’s default alone can leave a show on its previous setting. Plex says it will try to use other sources for matching after the cutoff.
Which Plex libraries need attention first
| Your setup | What Plex says to expect | First thing to check |
|---|---|---|
| Ongoing show using TheTVDB order | TheTVDB will stop supplying new episode and season details. | Compare the show’s numbering with TMDB and check its individual order setting. |
| Completed show with correct details | Existing metadata stays in place. | Check whether any individual show uses a special order before changing the library. |
| TVDB DVD or absolute order | Existing details remain. Plex plans support for TMDB episode groups. | Document the current order and check the show before switching. |
| Legacy TheTVDB agent | Plex says new shows or episodes will no longer match using that agent. | Check which agent the library uses and review the modern agent options. |
Metadata covers information such as episode titles and artwork. An episode order tells the server which episode those details belong to. The change concerns how Plex labels and matches a file. Plex’s announcement says existing libraries stay in place, so a mislabeled episode should be investigated as a matching issue first.
Start with one show before switching a whole library
Plex’s TV file-naming guide explains that the same series can have several legitimate episode orders. A DVD set can put episodes in a different sequence from the original broadcast. Two reference databases can also differ on the aired order. The difference matters when a filename uses the season and episode number from one listing and the library applies another.
For example, imagine a file numbered season one, episode two using the DVD sequence. If another listing puts that story in the third slot, a change of metadata order can associate the file with another episode’s title. The video file can remain where it was while its card or summary changes. This is why a small test with a known episode is more informative than changing the library and checking the total episode count.
To inspect the library default, edit the library, open Advanced and check Episode ordering. To inspect an individual series, edit the show and check its Advanced settings. If that show has its own TheTVDB preference, it takes precedence. Plex’s announcement recommends switching compatible series to The Movie Database, commonly called TMDB. A user with an alternate order that is working today can keep the existing setting while waiting for the announced TMDB episode-group support.
Before changing a heavily customized library, keep a record of which shows override the default and which order their files follow. Plex provides instructions for backing up its server data. For a first test, compare the titles and numbers of two or three known episodes before and after changing a single show. That can identify a mismatch before the same change is made across other series.
A useful check is to compare what the catalog says with what plays. Start with a series that has a special, a double-length story, or a reordered episode, and match the displayed title to the file you recognize. A library can show the expected number of episodes even if two descriptions are swapped. If the ordering already matches and the show has finished, the immediate reason to change it is limited.
Why older Plex installations face a separate change
Plex distinguishes episode ordering in the current Plex TV Series agent from a library running the legacy TheTVDB metadata agent. For the legacy agent, the company says new matching will stop. For a modern library that uses ordering from TheTVDB, Plex says it will attempt to match new titles using other sources. The effect depends on the library’s configuration and on the availability of matching records.
Plex said it was unable to reach a new agreement with TheTVDB’s owner. It gave Dec. 3 for ending support and left the date for TMDB episode groups open. The immediate choice for a server owner is which shows need fresh metadata and which depend on an order already working today. Find more software coverage in Newsmerica’s Tech & AI section.
Trust & transparency
How we handled this story
Plex’s Nov. 20 service announcement confirms the cutoff, existing metadata treatment and legacy agent behavior. The company’s naming and backup guides support the practical checks. TMDB episode groups remain a future feature without a stated date.
Grounded in this reporting
Ask Newsmerica
Ask about this article. Answers quote the closest published passages and link back to their sources.
This tool retrieves article passages; it does not add outside facts.Keep exploring
More from Newsmerica
Related coverage
Technology & AI
BepiColombo reaches Mercury orbit after eight years in space
Technology & AI
Tesla begins rolling out supervised Full Self-Driving v15
Technology & AI



