Files
jellyfin.org/docs/general/server/media/placeholders.md
T
2026-08-21 15:35:59 +02:00

2.1 KiB

uid, title
uid title
server-media-placeholders Media Placeholders

Media placeholders let you add video items to a Jellyfin library without providing a playable video file. These can be used to represent media that is unavailable, not currently present, or otherwise should exist in the library without an actual video file.

Create an empty file using the normal naming convention for the media, with .disc as the file extension.

For example:

Movies
└── Blade Runner (1982)
    └── Blade Runner (1982).disc

Jellyfin will add the movie to the library as a placeholder. The contents of the .disc file are not used.

Placeholder Types

An optional type can be added immediately before .disc:

Blade Runner (1982).dvd.disc
Blade Runner (1982).bluray.disc
Blade Runner (1982).vhs.disc

The following types are recognized:

Keyword Type
dvd DVD
hddvd HD DVD
bluray Blu-ray
brrip Blu-ray
bd25 Blu-ray
bd50 Blu-ray
vhs VHS
hdtv TV
pdtv TV
dsr TV

The type is optional. Any file ending in .disc is recognized as a placeholder.

The type must be directly before .disc. For example, MyMovie.bluray.disc is recognized as a Blu-ray placeholder, while MyMovie.bluray.custom.disc is still a placeholder but does not have a recognized type.

Other supported naming information can be combined with a placeholder as long as the placeholder type remains directly before .disc:

Movie (2020).3D.MVC.bluray.disc

Episodes

Placeholders can also be used for episodes by following the normal TV show naming conventions:

Shows
└── Example Show (2020)
    └── Season 01
        └── Example Show S01E01.dvd.disc

Client Behavior

Jellyfin adds placeholders to the library like other media items, allowing them to have metadata and artwork. The item is marked as a placeholder instead of playable media.