Custom Formats and Quality Profiles Explained for Radarr and Sonarr
A practical explanation of Radarr and Sonarr quality profiles, custom formats, minimum scores, upgrade-until scores, HEVC preferences, language rules, and TRaSH Guides.
Rights and lawful use: This profile and scoring workflow applies only to Radarr and Sonarr libraries you own or are authorized to manage. Custom formats, TRaSH-derived rules, and Recyclarr synchronization decide how eligible releases are scored; they do not authorize acquiring copyrighted media or bypassing a provider's terms.
Who this is for: Use this guide if Radarr or Sonarr shows a release yet rejects it, upgrades forever, selects an unwanted codec or language, or lets a weak source beat a better one. It explains quality, minimum-score, and upgrade-until controls for a first manual profile, then shows technical operators how to sync the same policy through versioned Recyclarr configuration.
The Simple Explanation
A quality profile answers the question: what quality is acceptable and when should upgrades stop? A custom format answers the question: among releases that fit the quality profile, which details do we prefer, reject, or penalize? Together they let Radarr and Sonarr make decisions that are much smarter than "download the biggest 1080p file."
Quality Is Not Just Resolution
A 1080p file can be excellent or terrible. A 4K file can be a beautiful source or an oversized headache that forces transcoding on every client. Codec, source, bitrate, release group, language, audio, subtitles, HDR format, edition, and naming all matter. Quality profiles and custom formats give the Arr apps a structured way to make those decisions.
The Key Fields
- Allowed qualities: the quality labels Radarr or Sonarr may grab.
- Quality cutoff: the quality level where normal quality upgrades stop.
- Minimum custom format score: the minimum score a release needs to be allowed.
- Upgrade until custom format score: the score where custom format upgrades stop.
- Language: the language behavior expected for the profile.
- Scores: positive or negative values applied when a release matches a custom format.
Quality profiles set the lane. Custom formats add scoring inside that lane.
1. QualityAllowed Quality?
The release must fit the quality profile before custom format scores can help.
2. LanguageCorrect Language?
Language rules block or penalize releases that do not match the library goal.
3. RejectHard No Signals
Strong negative custom formats stop releases you never want.
4. PreferPositive Signals
Preferred source, codec, group, edition, or audio characteristics add score.
5. MinimumPass Score?
Minimum score prevents low-value matches even when quality technically fits.
6. UpgradeCutoff Met?
Upgrade-until and quality cutoff decide when searching should stop.
A Good Cutoff Strategy
A bad strategy upgrades forever because something technically scores slightly higher. A good strategy stops when the release is good enough for the library. For a normal 1080p Plex library, that may be a strong WEB or Bluray source with the right language, no hardcoded unwanted subtitles, and no low-quality flags. For special movies, 4K or remux may make sense. For everyday content, it may not.
HEVC and 10-Bit Preferences
If your final standard is HEVC/H.265 10-bit, you can reward HEVC 10-bit releases in Radarr and Sonarr. But do not let codec preference beat source quality. A good H.264 source can be optimized by Tdarr. A bad HEVC encode may stay bad forever. Prefer good source quality first, then let Tdarr enforce the final storage and codec policy.
Language and Audio Rules
If your library should be English-only, custom formats and profiles can help reject or penalize unwanted languages. Audio rules should consider playback devices. Lossless surround can be great, but if every client transcodes it, you may want compatible surround tracks or fallback audio. For the Tdarr flow, commentary tracks can be removed and English subtitles retained after import.
Dolby Vision, HDR, and Compatibility
HDR and Dolby Vision need caution. Some clients support them well, some do not, and some files have profiles that create playback issues. Custom formats can penalize or prefer certain HDR/DV patterns, but Tdarr should also have guardrails so risky files are reviewed rather than blindly converted.
Using TRaSH Guides
The TRaSH Guides are a strong starting point because they maintain practical custom formats and profile logic for Radarr and Sonarr. They are not a substitute for understanding your own clients and storage goals. Import the guidance, then tune the scores and cutoffs to fit your environment.
Manual vs Automated Sync
You can add custom formats manually, or you can use tools like Recyclarr or similar configuration managers to keep profiles aligned with TRaSH Guides. Automation is helpful once you trust the configuration. Beginners should first understand what the profile is doing. Technical users should version-control the config and document any local score changes.
Common Mistakes
- Setting custom format upgrade score too high and causing constant upgrades.
- Rewarding HEVC so much that bad encodes beat good sources.
- Mixing 4K and 1080p goals in one profile.
- Ignoring language rules and importing unwanted releases.
- Forgetting that custom formats evaluate releases but do not improve indexer quality.
- Changing file names so much that future custom format matching loses useful information.
How This Ties Into Tdarr
Radarr and Sonarr should choose good source files. Tdarr should optimize final files. If the Arr profile is too weak, Tdarr wastes time polishing bad inputs. If the Arr profile is too aggressive, you waste bandwidth and indexer calls chasing marginal improvements. The sweet spot is good source selection plus controlled post-processing.
Beginner Walk-Through: Why a Release Gets Rejected
When Radarr or Sonarr searches, it scores results against your rules. A release can be visible and still be rejected. Maybe the quality is not allowed. Maybe the language does not match. Maybe a custom format gives it a negative score. Maybe the file is too large or too small. Interactive search is the best teaching tool because it shows rejection reasons.
Technical Scoring Pattern
- Use strong negative scores for releases you never want.
- Use modest positive scores for preferences like HEVC when source quality is still good.
- Use quality cutoffs to stop normal quality upgrades.
- Use custom format upgrade scores to stop detail-based upgrades.
- Avoid tiny scoring differences that trigger churn without visible benefit.
- Keep separate profiles for 1080p, 4K, anime, and special libraries when rules differ.
A Practical Rule of Thumb
Reject what is harmful. Prefer what is useful. Stop upgrading when the real-world viewing experience is good enough. That mindset keeps custom formats from becoming a game where the server endlessly chases a slightly higher score.
Implementation Playbook: Apply Profiles Without Creating Chaos
Manual Radarr/Sonarr Steps
- Back up Radarr and Sonarr before changing profiles.
- Create a new test quality profile instead of editing your production profile first.
- Import or create custom formats.
- Assign scores to the test profile.
- Set a minimum custom format score that blocks unwanted releases.
- Set an upgrade-until score that has a real stopping point.
- Run interactive search on a few known movies or episodes.
- Expand rejected results and read the rejection reasons.
- Only move a production library to the new profile after test searches make sense.
Docker Option: Recyclarr-Style Sync
Technical users often manage TRaSH-based custom formats with a config-sync tool. The advantage is repeatability. The risk is that a bad config can update many profiles at once. Keep the config in source control or at least back it up before syncing.
services:
recyclarr:
image: ghcr.io/recyclarr/recyclarr:latest
container_name: recyclarr
user: "1000:1000"
volumes:
- /opt/recyclarr/config:/config
environment:
- TZ=America/Chicago
restart: "no"
Production Docker note: After a Recyclarr test sync against nonproduction profiles shows only the intended custom-format and quality-profile changes, replace ghcr.io/recyclarr/recyclarr:latest with the tested tag or digest and retain /opt/recyclarr/config with the Radarr and Sonarr application backups. Run synchronization as a deliberate job, review its changes, and keep the previous scores available before applying an upstream guide update to production profiles.
Validation and Evidence
- Interactive search shows clear accepted and rejected results.
- Bad releases are rejected for the reason you intended.
- HEVC preference does not beat a better source release.
- Upgrade-until score does not create endless churn.
- Radarr and Sonarr still rescan files after Tdarr replacements.
- The profile name tells you what it is for, such as
1080p Balanced HEVC Preferred.
These are reader-run acceptance checks, not TechGeeks lab results. A clean interactive search proves that the current profile scores the sampled releases as intended. It does not prove every future release name will match, that an indexer result is authentic, or that every playback client supports the selected codec, audio, subtitle, and high dynamic range combination.
Security, Privacy, Legal, and Recovery Boundaries
Treat Radarr, Sonarr, Recyclarr, and indexer credentials as secrets. Do not place API keys in a public repository, expose an Arr admin interface directly to the internet, or give a profile-sync container broader file access than it needs. Search history, library names, and release metadata can reveal household interests, so limit log retention and access. These tools should only organize media you own or are authorized to use; scoring automation does not change copyright or service terms.
Before a bulk profile change, export the application backups and save the previous custom-format configuration and scores. Apply the new profile to a small test set first. If grabs or upgrades become noisy, stop automation, restore the prior profile, and review the decision history before deleting files. A configuration backup protects settings; it does not replace a separate backup of the media library and application database.
Related TechGeeks
This profiles entry sits between source discovery and post-processing in the media automation series. Radarr and Sonarr apply allowed qualities, language, custom-format scores, and upgrade cutoffs before a grab; Tdarr only optimizes the file after import. Use the linked install, storage, and backup guides to protect the application databases and preserve previous scores before synchronizing policy across a production library.
- Plex Homelab Architecture: Storage, GPU Transcoding, and Library Design
- Media Server Storage Design: NAS, CIFS/NFS Mounts, Permissions, and Local Cache
- Prowlarr Setup Guide: Clean Indexer Management for Sonarr and Radarr
- Sonarr Homelab Setup Guide: Install, Update, Optimize, and Connect to Tdarr
- Radarr Homelab Setup Guide: Install, Update, Optimize, Lists, and Tdarr Integration
- SABnzbd Performance Tuning for a Homelab Media Server
- Custom Formats and Quality Profiles Explained for Radarr and Sonarr
- Radarr Import Lists That Do Not Fill Your Library With Junk
- Plex + Tdarr GPU Strategy: Sharing NVIDIA GPUs Without Hurting Playback
- Reverse Proxy for Media Apps: Nginx Proxy Manager, SSL, Access Lists, and Security
- Backup and Disaster Recovery for Plex, Sonarr, Radarr, Tdarr, Prowlarr, and SABnzbd
- Monitoring and Health Checks for a Plex and Arr Homelab
- The Complete Plex, Arr, and Tdarr Homelab Media Automation Series
Related foundation: Building a Production-Grade Tdarr GPU Transcoding Stack for a Homelab.
References
- TRaSH Radarr quality profiles
- TRaSH Radarr custom formats
- TRaSH Guides for Sonarr
- Radarr Settings
- Sonarr Settings
Need help applying this?
Bring TechGeeks into the real environment.
If you are working through this on a live network, WordPress site, Linux server, AI workflow, or PisoWiFi deployment, send the context and we can help turn it into a practical plan.

