From 13427bde87cb1aa0fdd81e299a52e475675336a2 Mon Sep 17 00:00:00 2001 From: Kjeld Schouten Date: Tue, 9 Jun 2026 17:01:18 +0200 Subject: [PATCH 1/6] docs(settings): improve Metadata settings docs --- docs/using-seerr/settings/metadata.md | 53 +++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) create mode 100644 docs/using-seerr/settings/metadata.md diff --git a/docs/using-seerr/settings/metadata.md b/docs/using-seerr/settings/metadata.md new file mode 100644 index 0000000000..06caf78528 --- /dev/null +++ b/docs/using-seerr/settings/metadata.md @@ -0,0 +1,53 @@ +--- +title: Metadata Providers +description: Configure the metadata providers Seerr uses for TV and anime. +sidebar_position: 8 +--- + +# Metadata Providers + +Seerr fetches descriptive metadata (titles, descriptions, posters, release dates, +external IDs, etc.) from a number of third-party providers. The +**Settings → Metadata Providers** page lets administrators pick which provider +is used for each media type. + +A **Test** button at the top and bottom of the page exercises every configured +provider and updates the three status badges (`TheMovieDB`, `TheTVDB`). Each badge shows one of: + +- **Operational** — the test request succeeded. +- **Not tested** — no test has been run yet in this session. +- **Failed** — the test request errored; a toast describes which provider(s) + failed so the issue can be resolved without scrolling back up. + +## Metadata Provider Selection + +This section controls which provider is used for which media type. + + +### Series Metadata Provider + +Choose between **TheMovieDB** and **TheTVDB** as the source of metadata for TV +series. TheMovieDB is the default and matches the source used for movies, which +keeps IDs and artwork consistent across the UI. TheTVDB tends to have richer +episode-level data for long-running shows. + +### Anime Metadata Provider + +Choose between **TheMovieDB** and **TheTVDB** for anime entries. Many users +prefer **TheTVDB** here because its anime catalogue is typically more complete +and uses release-aligned numbering. + +Selection changes are persisted with the **Save** button at the bottom of the +page. + + +## Saving and Testing + +The **Save** buttons persist changes to `config/settings.json`. The **Test** +buttons make one request per provider: + +- TMDB / TVDB are tested only when selected as the active provider for one of + the media types. + +If any test fails, a toast is shown for that provider and its status badge is +updated; the other providers' results are independent. From cf3d1c9d08cbea2037e8110ad827d95960d9768d Mon Sep 17 00:00:00 2001 From: Kjeld Schouten Date: Tue, 9 Jun 2026 17:31:36 +0200 Subject: [PATCH 2/6] Apply suggestion from @Crow-Control --- docs/using-seerr/settings/metadata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/using-seerr/settings/metadata.md b/docs/using-seerr/settings/metadata.md index 06caf78528..9e3c3d6af9 100644 --- a/docs/using-seerr/settings/metadata.md +++ b/docs/using-seerr/settings/metadata.md @@ -12,7 +12,7 @@ external IDs, etc.) from a number of third-party providers. The is used for each media type. A **Test** button at the top and bottom of the page exercises every configured -provider and updates the three status badges (`TheMovieDB`, `TheTVDB`). Each badge shows one of: +provider and updates the two status badges (`TheMovieDB`, `TheTVDB`). Each badge shows one of: - **Operational** — the test request succeeded. - **Not tested** — no test has been run yet in this session. From 62a9164e9a270542036dfc8d40daf6f9ccd78a90 Mon Sep 17 00:00:00 2001 From: Kjeld Schouten Date: Tue, 9 Jun 2026 21:38:06 +0200 Subject: [PATCH 3/6] Update metadata.md --- docs/using-seerr/settings/metadata.md | 19 +++++++------------ 1 file changed, 7 insertions(+), 12 deletions(-) diff --git a/docs/using-seerr/settings/metadata.md b/docs/using-seerr/settings/metadata.md index 9e3c3d6af9..0429808bcf 100644 --- a/docs/using-seerr/settings/metadata.md +++ b/docs/using-seerr/settings/metadata.md @@ -28,17 +28,12 @@ This section controls which provider is used for which media type. Choose between **TheMovieDB** and **TheTVDB** as the source of metadata for TV series. TheMovieDB is the default and matches the source used for movies, which -keeps IDs and artwork consistent across the UI. TheTVDB tends to have richer -episode-level data for long-running shows. +keeps IDs and artwork consistent across the UI. -### Anime Metadata Provider -Choose between **TheMovieDB** and **TheTVDB** for anime entries. Many users -prefer **TheTVDB** here because its anime catalogue is typically more complete -and uses release-aligned numbering. +### Anime Metadata Provider -Selection changes are persisted with the **Save** button at the bottom of the -page. +Choose between **TheMovieDB** and **TheTVDB** for anime entries. ## Saving and Testing @@ -46,8 +41,8 @@ page. The **Save** buttons persist changes to `config/settings.json`. The **Test** buttons make one request per provider: -- TMDB / TVDB are tested only when selected as the active provider for one of - the media types. +*TMDB / TVDB are tested only when selected as the active provider for one of +the media types.* -If any test fails, a toast is shown for that provider and its status badge is -updated; the other providers' results are independent. +If any test fails, an error is shown for that provider and its status badge is +updated. From 727b3a6d1df4b7c30c9241373789df26637e246b Mon Sep 17 00:00:00 2001 From: Kjeld Schouten Date: Tue, 9 Jun 2026 22:49:16 +0200 Subject: [PATCH 4/6] Update metadata.md --- docs/using-seerr/settings/metadata.md | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/docs/using-seerr/settings/metadata.md b/docs/using-seerr/settings/metadata.md index 0429808bcf..459f85ebd8 100644 --- a/docs/using-seerr/settings/metadata.md +++ b/docs/using-seerr/settings/metadata.md @@ -23,23 +23,19 @@ provider and updates the two status badges (`TheMovieDB`, `TheTVDB`). Each badge This section controls which provider is used for which media type. - ### Series Metadata Provider Choose between **TheMovieDB** and **TheTVDB** as the source of metadata for TV series. TheMovieDB is the default and matches the source used for movies, which keeps IDs and artwork consistent across the UI. - ### Anime Metadata Provider Choose between **TheMovieDB** and **TheTVDB** for anime entries. - ## Saving and Testing -The **Save** buttons persist changes to `config/settings.json`. The **Test** -buttons make one request per provider: +The **Test** buttons make one request per provider. *TMDB / TVDB are tested only when selected as the active provider for one of the media types.* From e14852bde32a2f79a3c9f0b8a2c5d017b2950c19 Mon Sep 17 00:00:00 2001 From: Kjeld Schouten Date: Tue, 9 Jun 2026 22:55:52 +0200 Subject: [PATCH 5/6] Update metadata.md --- docs/using-seerr/settings/metadata.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/using-seerr/settings/metadata.md b/docs/using-seerr/settings/metadata.md index 459f85ebd8..9fb381b4fb 100644 --- a/docs/using-seerr/settings/metadata.md +++ b/docs/using-seerr/settings/metadata.md @@ -33,7 +33,7 @@ keeps IDs and artwork consistent across the UI. Choose between **TheMovieDB** and **TheTVDB** for anime entries. -## Saving and Testing +## Metadata Provider Testing The **Test** buttons make one request per provider. From 9db858570eb6667a597803763323032e9000ae14 Mon Sep 17 00:00:00 2001 From: Kjeld Schouten Date: Fri, 12 Jun 2026 10:54:07 +0200 Subject: [PATCH 6/6] Update metadata.md --- docs/using-seerr/settings/metadata.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/using-seerr/settings/metadata.md b/docs/using-seerr/settings/metadata.md index 9fb381b4fb..16570c737f 100644 --- a/docs/using-seerr/settings/metadata.md +++ b/docs/using-seerr/settings/metadata.md @@ -1,6 +1,6 @@ --- title: Metadata Providers -description: Configure the metadata providers Seerr uses for TV and anime. +description: Configure the metadata providers Seerr uses. sidebar_position: 8 --- @@ -23,7 +23,7 @@ provider and updates the two status badges (`TheMovieDB`, `TheTVDB`). Each badge This section controls which provider is used for which media type. -### Series Metadata Provider +### TV series Metadata Provider Choose between **TheMovieDB** and **TheTVDB** as the source of metadata for TV series. TheMovieDB is the default and matches the source used for movies, which