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.

    Updated November 22, 202612 min read

    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.

    SettingAppWhat it does
    Rename Episodes / Rename MoviesSonarr / RadarrMaster 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 CharactersBothCharacters that Windows and some file systems refuse (: \ / > < ? * | ") are replaced. When unchecked, they are simply removed.
    Colon ReplacementBothHow 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 FormatSonarrFile name pattern for each series type.
    Series Folder Format, Season Folder Format, Specials Folder FormatSonarrFolder names for the show, its seasons and season 0.
    Multi-Episode StyleSonarrHow a file containing two or more episodes is numbered.
    Standard Movie Format, Movie Folder FormatRadarrFile 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} gives 001), 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:

    StyleExample
    ExtendS01E01-02-03
    SceneS01E01-E02-E03
    RangeS01E01-03
    Prefixed RangeS01E01-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:

    Folder layout produced by Sonarr and Radarr
    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} gives Season 1. Season {season:00} gives Season 01, which sorts correctly past season 9. All the main servers read both.
    • Specials Folder Format: Specials is the usual value. Plex and Jellyfin also accept Season 00.
    • Movie Folder Format: {Movie CleanTitle} ({Release Year}) gives Dune (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:

    TokenExample outputUse
    {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}S01E01Zero-padded season and episode, required by every media server.
    {absolute:000}001Absolute episode number for anime.
    {Air-Date}2024-03-05Date for daily shows.
    {TvdbId}, {TmdbId}, {ImdbId}81189, 438631, tt1160419Database IDs, used inside server-specific tags like {tvdb-81189}.
    {Edition Tags}Final CutRadarr only: Director's Cut, Extended, IMAX and so on.
    {Quality Full}Bluray-1080p ProperSource, resolution, and Proper/Repack.
    {MediaInfo VideoCodec}, {MediaInfo AudioCodec}, {MediaInfo AudioChannels}x265, TrueHD Atmos, 7.1Read from the file itself after import.
    {MediaInfo VideoDynamicRangeType}DV HDR10HDR format, empty for SDR files.
    {Release Group}GROUPThe group that made the release.
    {Custom Formats}NF, iNTERNALOnly 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.

    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

    1. Set your formats in Settings > Media Management and turn on Rename Episodes or Rename Movies.
    2. 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.
    3. Check a few results, then confirm. Only the files you leave ticked are renamed.
    4. 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: Impossible into Mission - Impossible, Delete gives Mission 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

    Frequently asked questions

    What is the best Sonarr naming scheme for Plex?
    The TRaSH Guides scheme is the most common choice: {Series CleanTitleWithoutYear} {(Series Year)} - S{season:00}E{episode:00} - {Episode CleanTitle:90} followed by quality and media info tokens, with Season {season:00} folders and Prefixed Range for multi-episode files. For the series folder, add {tvdb-{TvdbId}} after the year so Plex matches the exact show. If you only care about Plex matching, {Series TitleYear} - S{season:00}E{episode:00} - {Episode Title} is enough.
    What is the recommended Radarr folder format?
    {Movie CleanTitle} ({Release Year}) works on every media server. TRaSH Guides adds an ID in the syntax of your server: {tmdb-{TmdbId}} for Plex, [tmdbid-{TmdbId}] for Jellyfin and [tmdb-{TmdbId}] for Emby. Remember that changing the folder format does not rename existing folders until you move them through the movie editor.
    How do I set up Sonarr anime naming?
    First set the show's Series Type to Anime, otherwise Sonarr uses the Standard format. Then use an Anime Episode Format that includes both S{season:00}E{episode:00} and {absolute:000}, for example {Series TitleYear} - S{season:00}E{episode:00} - {absolute:000} - {Episode Title}. Keeping both numbers lets Plex match by season and episode while the absolute number stays visible.
    Why is Sonarr not renaming my files?
    The most common reason is that Rename Episodes is unchecked in Settings > Media Management, so imports keep the release name. The setting also only applies to new imports. For files already in the library, open the series and use Preview Rename, or select several series in the list and use Rename Files.
    How do I add the episode title to Sonarr file names?
    Add {Episode Title} or {Episode CleanTitle} to the Standard Episode Format, usually after the episode number: {Series TitleYear} - S{season:00}E{episode:00} - {Episode Title}. To limit very long titles, use {Episode CleanTitle:90} as TRaSH Guides does. Then run a rename on existing series to update their files.
    Should I put the TVDB, TMDB or IMDb ID in folder names?
    It is optional but helpful, especially for remakes and shows with the same name. TRaSH Guides recommends TVDB IDs for Sonarr series and TMDB IDs for Radarr movies, since those are the apps' own metadata sources. Use the syntax your server expects: braces for Plex, square brackets for Jellyfin and Emby.
    How do I rename existing folders in Radarr or Sonarr?
    Set the new folder format first. Then in the movie or series list, enter selection mode, select the items, click Edit, keep the same root folder, apply, and confirm Yes, Move the files. Each folder is moved to a name built from the new format; on large or network libraries this can take a while, so do not interrupt it.
    Can I rename files that Sonarr and Radarr don't manage?
    Yes. Either import them with Library Import or Manual Import so the apps rename them, or use a manual renamer. RenameFlow renames such files in your browser to Plex or Jellyfin style names; it renames files only, so you create and fill the folders yourself.