Quick answer
What this guide helps you do
Fix Jellyfin subtitle burn-in and unnecessary transcoding. Learn which subtitle formats Direct Play, why PGS causes problems, and how to test client support.
Jellyfin beginner path
New to Jellyfin? Follow this order.
These guides form the SmallGrid Jellyfin path: install it, fix folder access, solve empty libraries, reduce unnecessary transcoding, then choose the right mini PC.
- Jellyfin on Ubuntu: Low-Power Setup, Media Folders and Reboot Checks
- Give Jellyfin Access to Media Folders on Ubuntu
- Jellyfin Library Not Showing Files: Fix Scans, Paths and Permissions
- Jellyfin Direct Play vs Transcoding: Differences, CPU Use and How to Check
- Best Mini PC Specs for Jellyfin: What Actually Matters
Difficulty
Beginner-friendly
Focus
Jellyfin setup and troubleshooting
Best used for
Practical setup, fixes, and checks
Quick answer
If Jellyfin only transcodes when subtitles are enabled, the subtitle format or client support is usually the cause.
Test this first:
- Play the file with subtitles off.
- Check the active session in the Jellyfin dashboard.
- Turn subtitles on.
- Check whether the session changes from Direct Play to Transcoding.
External SRT subtitles are usually the safest format. Image-based formats such as PGS often force Jellyfin to burn subtitles into the video, which requires full video transcoding.
Why subtitles cause transcoding
Subtitles can be either text-based or image-based.
Text-based subtitles contain characters that the client renders during playback. Image-based subtitles contain pictures that must be overlaid onto the video.
When the client cannot render the subtitle track itself, Jellyfin may burn the subtitles into every video frame. That forces video transcoding even when the video and audio would otherwise Direct Play.
Common subtitle formats:
| Format | Type | Typical result |
|---|---|---|
| SRT | Text | Best compatibility |
| WebVTT | Text | Good browser support |
| ASS/SSA | Styled text | May transcode on limited clients |
| PGS | Image | Often requires burn-in |
| VobSub | Image | Often requires burn-in |
How to confirm subtitle burn-in
Open the Jellyfin dashboard while the file is playing.
Look for a transcode reason such as:
SubtitleCodecNotSupported
Subtitle burn-in required
ContainerBitrateExceedsLimit
The exact wording can vary by client and Jellyfin version.
Compare these two tests:
Subtitles off: Direct Play
Subtitles on: Transcoding
That confirms the subtitle track is the trigger.
Use external SRT subtitles
External SRT files are widely supported and easy to manage.
Use matching names:
Film Name (2026).mkv
Film Name (2026).en.srt
For television:
Show Name - S01E01.mkv
Show Name - S01E01.en.srt
Place the subtitle file beside the video and rescan the library if it does not appear.
Try a different client
A file can transcode in a browser but Direct Play in a native Jellyfin app.
Test the same file on:
- Jellyfin Media Player
- Android TV
- Apple TV
- a smart-TV app
- a phone or tablet app
If only one client burns the subtitles in, the server and file may be fine. The limitation is client-side subtitle support.
Convert PGS subtitles to SRT
PGS subtitles are image-based. Converting them to SRT can avoid burn-in, but OCR is required because the images must be turned into text.
Tools such as Subtitle Edit can perform OCR and export SRT files.
Always proofread the result. OCR can misread punctuation, names, and timing.
Keep the original PGS track when accuracy matters, but add an SRT option for clients that cannot render PGS directly.
Check audio and video too
A subtitle track may not be the only reason Jellyfin is transcoding.
Check the dashboard for:
- unsupported video codec
- unsupported audio codec
- bitrate limits
- resolution limits
- container incompatibility
Use How to Check Why Jellyfin Is Transcoding for a complete diagnosis.
Best subtitle setup for Direct Play
A practical compatibility target is:
Primary subtitle: External SRT
Optional subtitle: Original PGS or ASS track
Client: Native Jellyfin app where possible
This keeps the original subtitle option while providing a lightweight text-based alternative.
Related guides
- How to Check Why Jellyfin Is Transcoding
- Jellyfin Direct Play vs Transcoding
- Best Video Format for Jellyfin Direct Play
- Jellyfin Direct Stream vs Direct Play
Recap
If subtitles trigger transcoding, test with subtitles disabled, inspect the transcode reason, and try an external SRT track.
PGS and VobSub are common causes of burn-in. A better client or a text-based subtitle track can often restore Direct Play without changing the video file.
Jellyfin guide cluster
More Jellyfin fixes and setup guides
These guides link the main Jellyfin setup, permissions, remote access, direct play, and hardware topics together.
Jellyfin on Ubuntu: Low-Power Setup, Media Folders and Reboot Checks
Build a reliable low-power Jellyfin server on Ubuntu. Install Jellyfin, mount storage, fix media access, favour Direct Play, measure power, and verify the server after reboot.
Give Jellyfin Access to Media Folders on Ubuntu
Fix Jellyfin permission denied errors on Ubuntu. Test the service user, find blocked parent folders, apply safe ACLs, verify inheritance, and check mounted-drive options.
Jellyfin Library Not Showing Files: Fix Scans, Paths and Permissions
Fix an empty Jellyfin library when scans find no media. Check storage mounts, paths, Linux permissions, Docker mappings, new-file access, scans, and logs in the correct order.
Jellyfin Docker Permissions: Fix Media Folder Access and UID/GID Errors
Fix Jellyfin Docker permission denied errors. Check bind mounts, container paths, UID and GID values, read-only media access, active mounts, and file visibility step by step.
Jellyfin Direct Play vs Transcoding: Differences, CPU Use and How to Check
Compare Jellyfin Direct Play, Direct Stream and transcoding. Learn how each affects CPU use and quality, why transcoding starts, and how to diagnose it.
Best Video Format for Jellyfin Direct Play: MKV, MP4, H.264 and HEVC
Choose the best video, audio, subtitle, and container formats for Jellyfin Direct Play. Compare MKV vs MP4, H.264 vs HEVC, and avoid unnecessary transcoding.