Sonarr & Radarr guide
Sonarr and Radarr naming schemes: the best formats for Plex, Jellyfin and Emby
Sonarr and Radarr can name every file and folder they import, but only if you tell them how. Out of the box, renaming is switched off and files keep whatever name the release had, which is how libraries end up full of Breaking.Bad.S01E01.720p.BluRay.x264-GROUP.mkv.
This guide walks through the Media Management settings one by one, explains the tokens worth using, and shows the naming schemes recommended by TRaSH Guides for Plex, Jellyfin and Emby. It also covers how to rename a library you already have, and what to do with the files Sonarr and Radarr will never touch.
Where the naming settings live
In both apps, naming is under Settings > Media Management. Some options, including Series Folder Format in Sonarr, are marked as advanced and stay hidden until you click Show Advanced at the top of the page. If a setting from this guide is missing, that toggle is the reason.
| Setting | App | What it does |
|---|---|---|
| Rename Episodes / Rename Movies | Sonarr / Radarr | Master switch. When it is off, imports keep the release name (or the original file name for manual imports) and every format below is ignored. |
| Replace Illegal Characters | Both | Characters that Windows and some file systems refuse (: \ / > < ? * | ") are replaced. When unchecked, they are simply removed. |
| Colon Replacement | Both | How a colon in a title is handled. The default, Smart Replace, turns Title: Subtitle into Title - Subtitle. Other choices are Delete, Dash, Space Dash and Space Dash Space. |
| Standard / Daily / Anime Episode Format | Sonarr | File name pattern for each series type. |
| Series Folder Format, Season Folder Format, Specials Folder Format | Sonarr | Folder names for the show, its seasons and season 0. |
| Multi-Episode Style | Sonarr | How a file containing two or more episodes is numbered. |
| Standard Movie Format, Movie Folder Format | Radarr | File and folder name for each movie. |
Each format field has a small ? button (or a token list below it) that opens the full token reference, and a live example under the field shows what a sample file would be called. Use that preview every time you edit a format: a missing space or brace is much easier to catch there than in a library of 4,000 files.
Turning on Rename Episodes or Rename Movies only affects new imports. Files already in your library keep their current names until you run a rename yourself (see the section on renaming an existing library).
Sonarr episode formats: Standard, Daily and Anime
Sonarr keeps three separate file name patterns. Which one applies depends on the Series Type you pick when adding a show (you can change it later in the series edit dialog).
- Standard: season and episode numbers, for almost every TV show.
Breaking Bad (2008) - S01E01 - Pilot.mkv - Daily: shows identified by air date, such as talk shows and news programs. Plex, Jellyfin and Emby can all match by date.
The Daily Show (1996) - 2024-03-05 - Episode Title.mkv - Anime: adds the absolute episode number (
{absolute:000}gives001), because many anime releases are numbered 1 to 1000 with no seasons. Setting a show to Anime also changes how Sonarr searches for it.
A good anime format keeps both numbers. Plex's own agents match anime by season and episode, while release groups and some tools count absolute episodes, so Jujutsu Kaisen (2020) - S01E01 - 001 - Ryomen Sukuna.mkv works everywhere.
Episode titles
{Episode Title} inserts the title from TheTVDB, and {Episode CleanTitle} does the same with some punctuation stripped. Titles can be long, so TRaSH Guides uses {Episode CleanTitle:90}, which caps the title at 90 characters. That matters on Windows, where full paths over 260 characters can cause problems unless long paths are enabled.
Multi-Episode Style
When one file holds two or more episodes (common with double-length premieres), Sonarr writes the numbers according to this setting. The main options:
| Style | Example |
|---|---|
| Extend | S01E01-02-03 |
| Scene | S01E01-E02-E03 |
| Range | S01E01-03 |
| Prefixed Range | S01E01-E03 |
Prefixed Range is what TRaSH Guides recommends, and S01E01-E03 is also the form Plex and Jellyfin show in their own naming docs. Duplicate and Repeat exist too, but they produce longer names that media servers handle less consistently.
Series, season and movie folder formats
Folder formats decide the structure your media server scans. The layout every server expects looks like this:
TV/
└── Breaking Bad (2008)/
├── Season 01/
│ └── Breaking Bad (2008) - S01E01 - Pilot.mkv
└── Specials/
Movies/
└── Dune (2021)/
└── Dune (2021).mkv- Series Folder Format:
{Series TitleYear}is the simplest good choice. TRaSH Guides uses{Series CleanTitleWithoutYear} {(Series Year)}, which avoids a doubled year when the TheTVDB title already contains one. - Season Folder Format: the default
Season {season}givesSeason 1.Season {season:00}givesSeason 01, which sorts correctly past season 9. All the main servers read both. - Specials Folder Format:
Specialsis the usual value. Plex and Jellyfin also acceptSeason 00. - Movie Folder Format:
{Movie CleanTitle} ({Release Year})givesDune (2021), the basic form every server understands.
Folder names are set when a series or movie is added. Changing a folder format later does not rename existing folders on its own; you have to trigger a move, as explained further down.
The tokens that matter
Sonarr and Radarr offer dozens of tokens. These are the ones that do real work in a naming scheme:
| Token | Example output | Use |
|---|---|---|
{Series TitleYear} | Breaking Bad (2008) | Show name with year, which separates remakes such as Battlestar Galactica (1978) and (2003). |
{Series CleanTitleWithoutYear} {(Series Year)} | Breaking Bad (2008) | Same idea, never doubles the year. The parentheses only appear when a year exists. |
{Movie CleanTitle} ({Release Year}) | Dune (2021) | Movie name and year, without characters that cause trouble on disk. |
S{season:00}E{episode:00} | S01E01 | Zero-padded season and episode, required by every media server. |
{absolute:000} | 001 | Absolute episode number for anime. |
{Air-Date} | 2024-03-05 | Date for daily shows. |
{TvdbId}, {TmdbId}, {ImdbId} | 81189, 438631, tt1160419 | Database IDs, used inside server-specific tags like {tvdb-81189}. |
{Edition Tags} | Final Cut | Radarr only: Director's Cut, Extended, IMAX and so on. |
{Quality Full} | Bluray-1080p Proper | Source, resolution, and Proper/Repack. |
{MediaInfo VideoCodec}, {MediaInfo AudioCodec}, {MediaInfo AudioChannels} | x265, TrueHD Atmos, 7.1 | Read from the file itself after import. |
{MediaInfo VideoDynamicRangeType} | DV HDR10 | HDR format, empty for SDR files. |
{Release Group} | GROUP | The group that made the release. |
{Custom Formats} | NF, iNTERNAL | Only the Custom Formats you marked with Include Custom Format when Renaming. |
Tokens with no value are dropped, along with the brackets or separators written inside the braces. {[Quality Full]} prints [WEBDL-1080p] when quality is known and nothing at all otherwise, which is why recommended formats put brackets inside the braces.
Quality, release group, edition and Proper/Repack are information you cannot recover from the video later. TRaSH Guides keeps them in file names for that reason: without them, Sonarr and Radarr can lose track of what you have, which can lead to unwanted re-downloads after a re-import.
Recommended formats for Plex, Jellyfin and Emby
The most widely used reference is the TRaSH Guides naming scheme for Sonarr and for Radarr. The formats below are reproduced from those pages as they stood on 22 November 2026; check them before copying, as they are updated from time to time.
Sonarr (TRaSH Guides)
{Series CleanTitleWithoutYear} {(Series Year)} - S{season:00}E{episode:00} - {Episode CleanTitle:90} {[Custom Formats]}{[Quality Full]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo VideoCodec]}{-Release Group}{Series CleanTitleWithoutYear} {(Series Year)} - {Air-Date} - {Episode CleanTitle:90} {[Custom Formats]}{[Quality Full]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo VideoCodec]}{-Release Group}{Series CleanTitleWithoutYear} {(Series Year)} - S{season:00}E{episode:00} - {absolute:000} - {Episode CleanTitle:90} {[Custom Formats]}{[Quality Full]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{MediaInfo AudioLanguages}{[MediaInfo VideoDynamicRangeType]}[{Mediainfo VideoCodec }{MediaInfo VideoBitDepth}bit]{-Release Group}With Season Folder Format set to Season {season:00} and Multi-Episode Style set to Prefixed Range, a file ends up looking like this (the exact tags depend on the file):
TV/
└── Breaking Bad (2008) {tvdb-81189}/
└── Season 01/
└── Breaking Bad (2008) - S01E01 - Pilot [WEBDL-1080p][EAC3 5.1][h264]-GROUP.mkv
Anime/
└── Jujutsu Kaisen (2020)/
└── Season 01/
└── Jujutsu Kaisen (2020) - S01E01 - 001 - Ryomen Sukuna [WEBDL-1080p][AAC 2.0][JA][h264 8bit]-GROUP.mkvRadarr (TRaSH Guides, Plex with TMDB ID)
{Movie CleanTitle} {(Release Year)} {tmdb-{TmdbId}} - {edition-{Edition Tags}} {[MediaInfo 3D]}{[Custom Formats]}{[Quality Full]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo VideoCodec]}{-Release Group}{Movie CleanTitle} ({Release Year}) {tmdb-{TmdbId}}Movies/
└── Blade Runner (1982) {tmdb-78}/
└── Blade Runner (1982) {tmdb-78} - {edition-Final Cut} [Bluray-2160p][TrueHD Atmos 7.1][DV HDR10][x265]-GROUP.mkv{edition-Final Cut} is Plex's edition tag: Plex shows the edition in its interface. If you keep two editions of the same movie, Plex lists them as separate items; TRaSH suggests replacing {edition-{Edition Tags}} with plain {Edition Tags} if you prefer a single entry. The Jellyfin version uses {{Edition Tags}} instead, while the Emby version keeps {edition-{Edition Tags}}.
ID tag syntax per server
The only real difference between the Plex, Jellyfin and Emby versions is how the ID is written. These are the forms TRaSH Guides uses:
| Server | Series folder | Movie folder |
|---|---|---|
| Plex | {tvdb-{TvdbId}} or {imdb-{ImdbId}} | {tmdb-{TmdbId}} or {imdb-{ImdbId}} |
| Jellyfin | [tvdbid-{TvdbId}] | [tmdbid-{TmdbId}] or [imdbid-{ImdbId}] |
| Emby | [tvdb-{TvdbId}] or [imdb-{ImdbId}] | [tmdb-{TmdbId}] or [imdb-{ImdbId}] |
So a Jellyfin movie folder reads Dune (2021) [tmdbid-438631] and an Emby one Dune (2021) [tmdb-438631]. Emby's own docs also accept forms such as [tmdbid=438631]. For the full server rules, see the Plex naming guide, the Jellyfin naming guide and the Emby naming guide.
A shorter alternative
If you find the long names hard to read in a file browser, this minimal scheme is enough for every server to match correctly. You lose the quality information discussed above, so keep it for libraries you rarely upgrade.
Standard Episode Format: {Series TitleYear} - S{season:00}E{episode:00} - {Episode Title}
Series Folder Format: {Series TitleYear}
Season Folder Format: Season {season:00}
Standard Movie Format: {Movie Title} ({Release Year})
Movie Folder Format: {Movie Title} ({Release Year})Why IDs in folder names help
A title and year are usually enough, but not always. Plex, Jellyfin and Emby all read an ID in the folder name and use it instead of guessing, which fixes the classic mismatches:
- Remakes and reboots with close or identical names: Shōgun (1980) and Shōgun (2024), or the two Battlestar Galactica series.
- Regional versions such as The Office (UK) and The Office (US).
- Titles that changed after release, or that differ between languages and metadata providers.
- Rebuilding a server from scratch: every item matches straight away, without fixing matches by hand.
Which ID to pick: TRaSH Guides recommends TVDB for series in Sonarr and TMDB for movies in Radarr, because those are the sources each app uses, so the ID is always there and always right. An IMDb ID is very stable, but it only works if the TVDB or TMDB entry links to the correct IMDb page. TRaSH also notes that TVDB and TMDB entries are occasionally deleted and re-added under a new ID, which is rare but worth knowing.
TRaSH Guides puts the movie ID in the file name as well as the folder. Folder names are written when the movie is added, while file names are rebuilt on every import or upgrade, so the file always carries a current ID.
TRaSH also warns that adding text after the year in movie folder names can cause problems during a fresh Library Import into Radarr. If you ever rebuild Radarr, check its suggested matches carefully.
How to rename an existing library in Sonarr and Radarr
Changing the formats does nothing to files already on disk. Here is the order that avoids surprises.
1. Get the library into Sonarr or Radarr
If your shows and movies are not in the apps yet, use Library Import (under Series in Sonarr, under Movies in Radarr). Point it at your root folder: each subfolder becomes one row with a suggested match that you can correct before importing. Sonarr and Radarr expect one folder per show or movie, so loose files at the root will not be picked up.
2. Preview and rename the files
- Set your formats in Settings > Media Management and turn on Rename Episodes or Rename Movies.
- Open one series or movie and click the rename button in the toolbar (labeled Preview Rename or Rename, depending on the version). A dialog lists every current name next to the new one.
- Check a few results, then confirm. Only the files you leave ticked are renamed.
- For the whole library, go back to the series or movie list, click Select Series or Select Movies, select all, and use Rename Files at the bottom of the screen.
3. Rename the folders
The file rename leaves folder names alone. To apply a new Series Folder Format or Movie Folder Format, TRaSH Guides describes this method: in the series or movie list, enter selection mode, select the items, click Edit, keep the same root folder they are already in, click Apply Changes, then answer Yes, Move the files in the warning. Each folder is moved to a path built from the new format.
A folder move on a large library, a network share or cloud storage can take a long time, because every file may be copied rather than moved instantly. Do not interrupt it, and make sure you have a backup first.
After the rename, let your media server rescan. Plex, Jellyfin and Emby normally match renamed files back to the same items, but adding ID tags can trigger a re-match, so spot-check a few shows and movies afterward.
Common naming problems and how to fix them
- New downloads keep their release names. Rename Episodes or Rename Movies is still off. It is a separate checkbox from the formats.
- Series Folder Format is missing. Click Show Advanced on the Media Management page.
- Plex lists a movie twice. You use
{edition-{Edition Tags}}and have two editions. Switch to{Edition Tags}or remove one edition. - Errors about path length on Windows. Shorten the episode title with
{Episode CleanTitle:90}(or a lower number), drop tokens you never use, or enable long paths in Windows. - Titles with colons look odd. Change Colon Replacement: Smart Replace turns
Mission: ImpossibleintoMission - Impossible, Delete givesMission Impossible. - Anime episodes are out of order. Check that the show's Series Type is Anime, and that the format includes both
S{season:00}E{episode:00}and{absolute:000}. - Files renamed by hand show as missing. Sonarr and Radarr track exact paths. If you rename a file they manage with another tool, run Refresh & Scan on that series or movie so the app finds it again, or simply let the app do the renaming.
Files that Sonarr and Radarr don't manage
Sonarr and Radarr only rename what they track. Plenty of media never goes through them: old DVD and Blu-ray rips, files copied from a friend's drive, downloads from before you set up the apps, family videos, or a second library on a laptop or external disk where you do not run any *arr app at all.
You have three options for those files:
- Bring them into Sonarr or Radarr with Library Import or Manual Import, if you want them monitored and upgraded. The matching step is much more reliable when the folder is already called
Title (Year). - Leave them messy and fix matches by hand in your media server. It works for a handful of items, not for hundreds.
- Rename them with a manual renamer so they follow the same scheme as the rest of the library, without adding them to the *arr apps.
Where RenameFlow fits
RenameFlow is a manual renamer that runs in Chrome, Edge or Opera on a desktop computer, with nothing to install. It reads release names such as Dune.2021.2160p.UHD.BluRay.x265-GROUP.mkv, identifies the title through TMDB, TheTVDB or AniList (for anime), lets you confirm or change each match, then renames the files in place on your disk. Your video files are never uploaded.
Its Plex and Jellyfin presets produce Dune (2021).mkv for movies, Breaking Bad - S01E01 - Pilot.mkv for series and Jujutsu Kaisen - S01E01.mkv for anime, so the files line up with the minimal scheme above. Multi-episode files like S01E01-E02 are handled, and files inside a VIDEO_TS or BDMV disc structure are left alone. With a Pro plan you can write your own pattern using tokens such as {title}, {year}, {season}, {episode}, {episodeTitle}, {quality}, {source}, {codec} and {group}, which lets you keep quality and release group in the name the way TRaSH recommends.
RenameFlow renames files only. It does not create, move or rename folders and it does not add ID tags. Create the Dune (2021) or Breaking Bad (2008)/Season 01 folders yourself and move the files into them, then add the files to Sonarr or Radarr if you want them managed from there on. For files that Sonarr or Radarr already track, use the apps' own rename feature instead.
Clean up the files your *arr apps never touch
Rename old rips and stray downloads to Plex and Jellyfin naming in your browser. Files stay on your disk and you confirm every match.
Try RenameFlow free