Import Exclusions

Prevent specific movies from being re-added to your library by import list syncs. Exclusions are checked before every sync and act as a permanent block list for unwanted movies.

Overview

What are Import Exclusions?

Import lists are additive — they automatically add movies to Luminarr as new titles appear in the source feed. Without exclusions, deleting a movie from your library would result in it being re-added the next time that import list syncs.

Import exclusions give you permanent, per-movie control: once a TMDB ID is in the exclusion list, no import list will add that movie again, no matter how many lists reference it.

What they prevent

Import list syncs re-adding a movie you deliberately removed. Unwanted titles from broad lists like "Popular" or "Trending" cluttering your library.

What they don't prevent

Manually adding an excluded movie via search or the Add Movie page. Exclusions only block import list automation.

Automatic Exclusions

Auto-added on Delete

When you delete a movie from Luminarr, you are given the option to also add it to the import exclusion list. Enabling this option ensures the movie won't come back the next time your import lists sync. This is the most common way exclusions are created.

The exclusion record stores the movie's TMDB ID and title at the time of deletion. The title is displayed in the exclusions list for readability — matching is always done by TMDB ID, not by title.

  1. 1

    Delete a movie

    From the movie detail page or the library view, choose Delete. A confirmation dialog appears.

  2. 2

    Choose "Add to import exclusions"

    Check the option in the delete dialog before confirming. The movie is removed from Luminarr and an exclusion record is created simultaneously.

  3. 3

    Exclusion takes effect immediately

    The next import list sync will find the TMDB ID in the exclusion list and skip the movie silently.

Managing Exclusions

Viewing and Managing the Exclusion List

The import exclusions list is available under Settings → Import Lists → Exclusions. It shows the movie title, TMDB ID, and when the exclusion was created.

Adding exclusions manually

You can manually add an exclusion by entering a TMDB ID directly from the exclusions page. This is useful when you want to pre-emptively exclude a movie that keeps appearing in a "Popular" or "Trending" list before it ever gets added.

Removing an exclusion

To allow a previously excluded movie to be added again by import lists, simply delete its entry from the exclusions list. The next sync cycle will treat it as a new movie.

Removing an exclusion does not add the movie. Deleting an exclusion record only allows future import list syncs to add the movie. It does not immediately add it — that happens on the next sync.

What each record stores

Field Description
TMDB ID The numeric TMDb movie ID. This is the key used for matching during sync.
Title Movie title at the time the exclusion was created. For display only — not used for matching.
Created At Timestamp when the exclusion was added.