Skip to content

Exclusions

MMagTech edited this page Mar 17, 2026 · 9 revisions

Exclusions

The Exclusions list lets you permanently prevent specific titles from being searched by Nudgarr. Excluded titles are silently skipped in every future sweep — both Cutoff Unmet and Backlog searches.


How exclusions work

Exclusions are matched by title (case-insensitive, exact string match). When a sweep runs, Nudgarr removes any item whose title appears on the exclusions list before the cooldown check, queue check, or search selection. Excluded items are never counted against the run's maximum — they are removed from consideration entirely.

Exclusions are global — they apply across all instances and both Radarr and Sonarr.


Adding exclusions

From the History tab (desktop)

The most common way to add an exclusion is directly from History:

  1. Open the History tab
  2. Find the title you want to exclude
  3. Click the icon in that row
  4. The title is immediately added to the exclusions list

From the History tab (mobile)

On mobile, open the History tab from the bottom nav, then tap Add in the inner tab bar to see recently searched titles. Tap the + button next to any title to exclude it.


Removing exclusions

Desktop

Open the Advanced tab and find the Exclusions section. Each excluded title has a Remove button. Removing it immediately makes the title eligible for future sweeps.

Removing exclusions — Mobile

In the History tab, tap Excluded in the inner tab bar to see all active exclusions. Each title has a Remove button. The row fades and collapses before the removal is confirmed.


What exclusions are for

Exclusions are useful for titles you have a deliberate reason not to improve or acquire:

  • Content you own physically and don't want a digital copy of
  • Items with no reliable indexer releases — repeatedly searching wastes slots
  • Content you've decided isn't worth the quality upgrade at this time
  • Items that repeatedly trigger false positives in your indexer results

Exclusions are not the right tool for temporarily pausing a title — that's what the cooldown handles naturally. If you just searched something and don't want it re-searched soon, the cooldown already prevents that without an explicit exclusion.


Exclusions and Sonarr show-level management

Nudgarr excludes by title only. For Sonarr, this means excluding a show title will skip all episode searches for that show — but it won't remove it from your Sonarr library or un-monitor it.

If you want to stop Nudgarr from ever touching a show again and stop Sonarr from looking for it in RSS, the right approach is to un-monitor the show (or specific seasons/episodes) in Sonarr directly. Nudgarr only searches monitored content.


Storage

Exclusions are stored in the SQLite database at /config/nudgarr.db. They are persisted across restarts and container upgrades.

Clone this wiki locally