# Plex NFO Agent Forum Preview

**URL:** <https://forums.plex.tv/t/plex-nfo-agent-forum-preview/936104>\
**Category:** Metadata & Adding Files\
**Tags:** feature-preview\
**Created:** [February 6, 2026, 9:40am UTC](https://forums.plex.tv/t/plex-nfo-agent-forum-preview/936104 "2026-02-06T09:40:29Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![drzoidberg33](https://sea1.discourse-cdn.com/plex/user_avatar/forums.plex.tv/drzoidberg33/32/4184_2.png) [@drzoidberg33](https://forums.plex.tv/u/drzoidberg33)\
**Post date:** [February 6, 2026, 9:40am UTC](https://forums.plex.tv/t/plex-nfo-agent-forum-preview/936104/1 "2026-02-06T09:40:29Z")

</div>

Hi everyone!

Official support for NFO files has been a highly requested feature for a long time and we promised it would be coming towards the end of last year. Some other priorities got in the way of that but today I wanted to share the first preview build to get some feedback and test it out in the wild before we release it publicly.

This preview has support for movie and TV show (including season/episode) NFO files. Music NFO support is not currently on the roadmap but we will reevaluate that depending how much demand there is for it.

We support the widely used Kodi/XBMC NFO format. Most NFO generation tools will output to this format, if you use a tool like TinyMediaManager you can also configure the output to use the Plex preset.

## How to Use

Once you have downloaded and installed the preview build below, create a new library and point it to your Movie or TV Shows path. Before saving the library, go to the Advanced pane in the library creation and choose “Plex NFO Movie” or “Plex NFO Series” from the “Agent” dropdown (if you don’t see this option please try to refresh the page in your browser).

## Recommended file structures

> Local image asset naming below is just one example, see supported options here:
> 
> [https://support.plex.tv/articles/200220677-local-media-assets-movies/](https://support.plex.tv/articles/200220677-local-media-assets-movies/)
> 
> [https://support.plex.tv/articles/200220717-local-media-assets-tv-shows/](https://support.plex.tv/articles/200220717-local-media-assets-tv-shows/)

#### Movies

> `movie.nfo` is the generally accepted naming if you have separate folders for each movie file. Using the exact name of the movie file is also supported, e.g. `A Movie (2026).nfo`

```auto
/Movies
  /A Movie (2026)
    A Movie (2026).mkv
    movie.nfo
    poster.jpg
    background.jpg
    logo.png
    square.jpg

```

#### TV Shows

> `season.nfo` is mostly ignored, and is not required.
> 
> Episode NFO files are the minimum requirement but having a `tvshow.nfo` is highly recommended.

```auto
/TV Shows
  /A TV Show (2026)
    tvshow.nfo
    poster.jpg
    background.jpg
    logo.png
    square.jpg
    /Season 01
      season.nfo
      A TV Show (2026) - S01E01.mkv
      A TV Show (2026) - S01E01.nfo
      A TV Show (2026) - S01E01.jpg

```

## Notes about the current implementation

- ~~Ratings (TMDB/IMDB/TVDB) are not yet supported.~~ Support added in build 10505
- [Multi-part files](https://support.plex.tv/articles/naming-and-organizing-your-movie-media-files/#toc-3) are not currently supported.
- ~~FIles spanning [multiple episodes](https://support.plex.tv/articles/naming-and-organizing-your-tv-show-files/#toc-5) are not currently supported.~~ Support added in build 10505
- While this agent does not require anything to be pulled from online sources, if you do not provide local image assets alongside your files, and the NFO points to an online asset it will try to pull the online version.
- We may consider some advanced configuration options to allow more flexibility in the supported NFO formats, this will depend on user feedback.
- Using embedded metadata inside MP4s will not be preferred over the NFO metadata using the default Plex NFO agent. You can still achieve this if you wish by creating a custom Metadata Agent (Settings → Metadata Agents) using the appropriate NFO provider as the primary provider and adding the Plex Local Media provider in the first position (see example below).

 ![image](https://global.discourse-cdn.com/plex/original/4X/c/3/a/c3ac988c25b048247ed50e48cd72cbb1d1a836ef.png)

## Accepted risk using preview builds

As preview builds have not undergone strict QA testing, issues may arise which could range from minor annoyances to permanent loss of data to your Plex database.

We always recommend running preview builds separately from your main PMS installation if possible. If you choose to use your existing database please ensure that you have recent backups.

---

_[View the full topic](https://forums.plex.tv/t/plex-nfo-agent-forum-preview/936104)._