How to Troubleshoot Kodi Issues Using the Official Kodi Wiki

Updated

The Official Kodi Wiki (kodi.wiki) is the community-maintained documentation hub for Kodi, and it has a dedicated Troubleshooting section plus a FAQs page that cover the most common problems. Use it when you hit an error, a playback failure, or a setup question — it's the fastest path to an official, community-reviewed answer before you post on the forum.

Where the troubleshooting content lives

The wiki's main navigation groups its content into clear categories. The ones most useful for problem-solving are:

Section What it helps with
Troubleshooting Step-by-step fixes for errors, crashes, and playback issues
FAQs Short answers to recurring "why does Kodi do X?" questions
Installing & First time user Setup problems, first-run configuration
Settings Locating and changing configuration options
Video, Movie & TV Show Library Library scanning, metadata, and source issues
Music & Music Video Library Music library and tagging problems
Live TV, PVR & Radio PVR backend and tuner issues
Add-ons Add-on installation and management problems
Remote Controls Input device and remote configuration
Devices / Hardware Platform-specific hardware issues
Skins Interface and skin-related problems

If your issue is platform-specific (Android, iOS, Linux, Mac OS X, Windows), check the Devices / Hardware and platform pages under the "more..." menu, since fixes often differ by operating system.

A practical troubleshooting workflow

  1. Identify the symptom precisely. Note the exact error message, what you were doing, and which platform you're on. This determines which wiki section applies.
  2. Start with FAQs. Many issues (library not updating, add-on not appearing, playback stuttering) are answered there in a few lines.
  3. Move to Troubleshooting. This section holds the detailed diagnostic and fix guides.
  4. Check the relevant feature section. If the problem is tied to a specific area — PVR, library, skins — go straight to that page rather than the general troubleshooting list.
  5. Search the wiki. Use the search box in the navigation menu to look up your exact error text or feature name.
  6. Check the forum rules and banned add-ons list before posting. The wiki links to Forum Rules and Items Banned from Forum. If your issue involves a banned add-on, the community won't help troubleshoot it — so verify this early to avoid wasted effort.

What to do when the wiki doesn't solve it

The wiki is maintained by the open community alongside Team Kodi members, so it may not cover every edge case. If you've worked through the relevant pages and still have a problem:

  • Note that new account registrations are disabled on the wiki. If you want an account to help edit it, you must request one through the link provided on the main page.
  • For support questions, the wiki points you toward the Kodi forum — read the Forum Rules first, and confirm your add-on isn't on the banned list.

Key things to remember

  • The wiki is documentation, not a live support channel — it won't respond to questions, but it answers most common ones.
  • Content is available under Attribution-ShareAlike 3.0 Unported unless otherwise noted, and the main page was last edited on 22 February 2023, so some details may lag behind the newest Kodi release.
  • Always check the banned add-ons list before asking for help, since banned items are outside community support.