Where Is the Kodi userdata Folder?
Kodi userdata folder with guisettings.xml, sources and addons database on Windows, macOS and Linux.
Last updated
Kodi keeps settings, library databases, keymaps and thumbnails in userdata. The files that matter most are guisettings.xml (options), sources.xml (media paths) and the MyVideos/MyMusic databases.
Addons themselves sit next to userdata in an addons folder. Copying userdata alone moves settings and libraries; addons need their own copy.
Where Kodi stores this, by platform
%APPDATA%\Kodi\userdata
Portable installs use a portable_data folder next to the exe instead. Database folder holds versioned MyVideos files; keep the version matching your Kodi.
~/Library/Application Support/Kodi/userdata
Same internal layout. In Finder use Go > Go to Folder, since Library is hidden.
~/.kodi/userdata
Flatpak installs redirect under the Flatpak data dir. Same guisettings.xml and Database layout inside.
Frequently asked questions
How do I migrate Kodi to a new device?
Copy userdata plus the addons folder to the same spots on the new install with Kodi closed. Rescan sources only if media paths changed.
Kodi lost my library after an update. What happened?
Major versions create a fresh versioned database and migrate a copy. Old databases stay behind; point sources at the new one rather than deleting.
Notice an outdated path? Let us know.