Kodi Subtitles Not Working? 7 Fixes That Actually Work
Kodi’s subtitle system has more moving parts than most players’: language preferences, subtitle service add-ons with their own logins, per-video track selection, and timing offsets. When subtitles refuse to appear, the cause is almost always one of seven things. Work through them in order — most people are fixed by number three.
Scope note: this guide is about Kodi’s own subtitle handling (downloaded and local subtitles inside the Kodi app). If your problem is subtitles missing on Netflix, Disney+, or a browser stream, that’s a different system — see our general guide to fixing subtitles on streaming services instead.
Fix 1: Turn Subtitles On During Playback (The Obvious One)
Before anything else, confirm subtitles are actually enabled for the video you’re watching:
- Start playing the video.
- Press T on a keyboard (or open the on-screen display and find the subtitle toggle) to toggle subtitles.
- Alternatively, open the OSD (press M or tap the screen), go to the audio/subtitle settings (speaker icon), and check which subtitle track is selected.
Kodi remembers subtitle preferences per video in some configurations, so a track you turned off last week stays off. If no tracks are listed at all, the problem is upstream — keep reading.
Fix 2: Set Your Preferred Subtitle Language
Kodi only auto-selects subtitle tracks matching your language preference. If it’s unset or wrong, Kodi may have subtitles available and simply not choose them.
- Go to Settings > Player > Language.
- Set Preferred subtitle language to your language (e.g., English).
- While you’re here, check Preferred audio language too — mismatches here can confuse auto-selection.
This one setting silently causes a huge share of “subtitles not working” reports: the subtitles download fine, but Kodi doesn’t auto-enable them because it doesn’t know which language you want.
Fix 3: Install and Configure a Subtitle Service Add-on
Kodi doesn’t ship with subtitle downloading enabled — you need a subtitle service add-on, and the most reliable ones need a free account.
OpenSubtitles.org is the standard choice:
- Go to Add-ons > Install from repository > Kodi Add-on repository > Subtitles.
- Install OpenSubtitles.org.
- Configure it with your OpenSubtitles.org username and password. This step is mandatory — OpenSubtitles now requires a free registered account for API access, and the add-on will silently fail without valid credentials. Create the account on their website first if you don’t have one.
- Back in Kodi, go to Settings > Player > Language and enable subtitle downloading / set your subtitle service.
Alternatives like a4kSubtitles (which aggregates multiple providers) are popular when OpenSubtitles comes up empty for a particular title. You can install more than one service and Kodi will try them in order.
To download subtitles for the video currently playing: open the subtitle OSD during playback and choose Download subtitles — Kodi queries your configured services and lists matches.
Fix 4: Check the Subtitle Add-on’s Login and Status
If subtitles used to download and suddenly stopped, the add-on’s authentication is the prime suspect:
- Open Add-ons > My add-ons > Subtitles, select your subtitle service, and open Configure.
- Re-enter your username and password — password changes and expired sessions break the login silently.
- Check the provider’s website status. Free subtitle APIs occasionally rate-limit or go down; when they do, every Kodi user is affected at once and the only fix is waiting (or a second provider add-on).
- After fixing credentials, try downloading subtitles again from the playback OSD.
This “it worked last month” failure mode is almost always auth-related. Bookmark this fix — you’ll need it again someday.
Fix 5: Use a Local SRT File With a Matching Name
When downloads fail or return garbage, a local subtitle file is the bulletproof fallback:
- Download an
.srtfor your video from a subtitle site. - Name it exactly like the video file (e.g.,
Dune.Part.Two.2024.mkv→Dune.Part.Two.2024.srt, optionallyDune.Part.Two.2024.en.srt) and put it in the same folder. - In Kodi, play the video, open the subtitle OSD, and select the local track.
Kodi picks up same-named SRTs automatically. This method bypasses add-ons, accounts, and APIs entirely — if subtitles work from a local file but not from downloads, you’ve isolated the problem to the subtitle service, not Kodi’s playback.
Fix 6: Adjust the Subtitle Offset (Timing)
Subtitles present but out of sync? Kodi has a built-in offset control:
- During playback, open the OSD subtitle/audio settings.
- Find Subtitle offset and nudge it forward or backward until dialogue lines up.
- To make the offset stick for all videos, choose Set as default for all media at the bottom of that settings panel.
If the drift gets progressively worse over the video (fine at the start, seconds off by the end), that’s a frame-rate mismatch in the subtitle file — no offset will fix it. Download a different subtitle matched to your release, or re-time the SRT on a computer with Subtitle Edit’s Visual Sync.
Fix 7: Check Encoding, Formats, and the Nuclear Options
A few remaining culprits:
- Garbled text instead of words: wrong character encoding. In Settings > Player > Language, check the subtitle character set options, or re-save the SRT as UTF-8 on a computer.
- Styling-heavy ASS subtitles misbehaving: Kodi handles ASS/SSA reasonably, but exotic styling can glitch. An SRT version of the same subtitle usually behaves.
- A specific video only: the file’s embedded subtitle track may be corrupt. Remux or use an external SRT.
- Nothing works anywhere: clear Kodi’s cache (Settings > … varies by skin; alternatively check for a maintenance add-on), and as a last resort, reset the Player/Language settings to defaults and reconfigure from Fix 2 onward. Reinstalling Kodi itself is rarely necessary — settings are the problem 99% of the time.
Quick Diagnosis Table
| Symptom | Most likely cause | Fix |
|---|---|---|
| No subtitle tracks listed at all | No subtitle service configured / no local file | Fixes 3 and 5 |
| Tracks listed but won’t enable | Preferred language unset | Fix 2 |
| Downloads fail suddenly (worked before) | Add-on login expired | Fix 4 |
| Subtitles appear but mistimed | Offset / wrong release | Fix 6, then re-download |
| Garbled characters | Encoding mismatch | Fix 7 |
| Works for some videos, not others | Per-video toggle / bad embedded track | Fix 1, then Fix 5 |
Frequently Asked Questions
Do I need an account to download subtitles in Kodi?
For OpenSubtitles.org — yes, a free account, entered into the add-on’s settings. Without it, downloads fail silently. Some aggregator add-ons work without accounts but are less consistent.
Why did Kodi subtitles stop working after an update?
Major Kodi updates can reset add-on settings or break old add-on versions. Re-check your subtitle service’s configuration and credentials (Fix 4), and make sure the add-on itself is updated to a version compatible with your Kodi release.
What’s the keyboard shortcut for subtitles in Kodi?
T toggles subtitles during playback. For the full subtitle menu (download, offset, track selection), open the OSD with M and go to the subtitle settings.
Can Kodi auto-download subtitles for my whole library?
Kodi downloads subtitles on demand per video rather than in bulk. For a large local library, many users prefer downloading SRT files on a computer, naming them to match, and letting Kodi pick them up automatically (Fix 5) — it’s faster and doesn’t depend on API availability.
Why do downloaded subtitles never match my video’s timing?
You’re likely getting subtitles synced to a different release (BluRay vs WEB-DL vs extended cut). In the download results list, prefer entries whose release tags match your file. When nothing matches, a local SRT from a subtitle site chosen for your exact release usually beats another round of auto-downloads.
Is it legal to download subtitles?
Subtitle files themselves are typically user-created transcriptions; downloading them for media you own is widely practiced and subtitle providers operate openly. Ripping or sharing the underlying video is a separate matter governed by copyright law in your country. (This is general information, not legal advice.)
Conclusion
Kodi subtitle failures are almost never mysterious: set your preferred subtitle language, install a subtitle service add-on with valid login credentials, and keep a matching local SRT as backup. Work the seven fixes in order and you’ll resolve the vast majority of cases — and when downloads misbehave, remember that a correctly named local subtitle file bypasses every point of failure at once.
