⚠️ STATUS DISCLAIMER
Feature Status: 🟢 FULLY AVAILABLE
Important Note: Kodi’s parental controls are designed to protect the interface from curious children—they will not prevent tech-savvy users from accessing Kodi’s content and settings files directly through the operating system. The feature may also be bypassed via the web interface or certain add-ons.
If you need stronger protection, consider operating system-level user accounts or third-party parental control software in addition to Kodi’s built-in features.
🔒 Privacy Reminder: If you use third-party add-ons, your IP address is exposed. A VPN is strongly recommended to protect your privacy and prevent ISP tracking.
What Are Kodi Parental Controls?
Kodi is a powerful, open-source media center that transforms any device into an all-in-one entertainment hub. It gives you access to your personal media library—movies, TV shows, music, photos, and even live TV—all from a single, customizable interface.
The Problem: With great content comes great responsibility. If you share your Kodi media center with children, you need a way to ensure they don’t accidentally stumble upon inappropriate content or change critical settings.
The Solution: Kodi comes with built-in parental control features that let you:
- 👨👩👧👦 Create separate profiles for each family member
- 🔒 Lock specific sections of Kodi (settings, add-ons, file manager, etc.)
- 📺 Restrict live TV channels with a PIN
- ⏱️ Limit daily viewing time with the Wellbeing add-on
- 🎯 Filter content using smart playlists based on ratings
📋 “No-Click” Quick-Reference Cheatsheet
For experienced users—skip the reading and set up now.
| Item | Details |
|---|---|
| Best Method | Create a separate Child Profile with locked settings |
| Master Lock Location | Settings → Interface → Master Lock |
| Default PIN Attempts | 3 attempts before restart required |
| Profile Storage | userdata/profiles/ folder |
| Master Lock File | profiles.xml in userdata folder |
| Login Screen Setting | Profiles → General → Show login screen on startup |
| Kodi Version | Works on Kodi 20 “Nexus” and above (including 21 “Omega”) |
| Last Verified | August 4, 2026 |
How to Set Up Kodi Parental Controls – Step-by-Step
Part 1: Create a Child Profile (The Foundation)
Profiles are the cornerstone of Kodi’s parental control system. They allow each user to have their own separate media library, settings, and add-ons without interfering with each other.
Step 1: Open Settings
- Launch Kodi and click the gear icon (⚙️) in the top-left corner to access the Settings page.
Step 2: Navigate to Profiles
- Click on “Profiles” in the settings menu.
Step 3: Enable Login Screen
- Click on “General” and make sure “Show login screen on startup” is enabled. This ensures that when Kodi starts, users must select their profile.
Step 4: Add a New Profile
- Select “Profiles” from the left menu. You’ll see the default “Master User” profile.
- Click “Add Profile” to create a new one.
Step 5: Name Your Profile
- Enter a name for your child’s profile (e.g., “Kids,” “Children,” or their name) and click OK.
Step 6: Choose Profile Directory
- You’ll see a “Browse for Folder” field:
- Default – Settings are stored in the
userdata/profiles/folder with the profile name. - New Folder – Create a custom folder location for the profile.
Step 7: Configure Lock Preferences
- In the Edit Profile window, you can lock specific sections:
- Lock Music Window – Prevents access to the music section
- Lock Videos Window – Blocks access to all videos (movies, TV shows)
- Lock Pictures Window – Locks the pictures section
- Lock Programs and Scripts – Prevents access to advanced Kodi features
- Lock File Manager – Stops users from adding new sources
- Lock Settings – Prevents changes to Kodi settings
- Lock Add-ons Manager – Prevents installing/uninstalling add-ons
Step 8: Configure Media Settings
- Media Info – Choose whether this profile has separate or shared media information.
- Media Sources – Choose whether this profile has separate or shared media sources.
Part 2: Set Up Master Lock (The PIN Protection)
The Master Lock applies a PIN to specific areas of Kodi, adding an extra layer of security.
⚠️ Important: Master Lock settings are profile-specific. To lock other profiles, you must repeat these steps while logged into each profile.
Step 1: Open Interface Settings
- Launch Kodi and click the gear icon (⚙️) to access Settings.
- Click on “Interface”.
Step 2: Switch to Expert Mode
- Click the little gear icon at the bottom of the left menu until it says “Expert” . This reveals advanced options.
Step 3: Select Master Lock
- Click on the “Master Lock” tab.
Step 4: Choose Lock Type
- Click on the top option “Master Lock” (initially shows “Disabled”).
- Choose your lock type:
- Disabled – No lock
- Digital password – Numeric PIN (recommended)
- Gamepad Buttons Combo – Button combination
- Full text password – Text password
Step 5: Set Your PIN
- Enter your chosen numeric password and click “Done” .
- Re-enter your password when prompted and click “Done” again.
Step 6: Choose What to Lock
- In the Lock Preferences section, select which features to protect:
- Music Window
- Videos Window
- Pictures Window
- Programs and Scripts
- File Manager
- Settings
- Add-ons Manager
Step 7: Enable Startup Lock (Optional)
- Toggle “Request master lock code on startup” to ON if you want to prevent access to the entire Kodi program without a PIN.
Note: After enabling Master Lock, you may need to restart Kodi for all settings to take effect.
Part 3: Configure Your Child’s Media Library
Now that the profile and lock are set up, you need to log into the child profile and configure what content they can access:
Step 1: Switch to Child Profile
- Restart Kodi or log out and select the child profile from the login screen.
Step 2: Add Approved Media Sources
- Go to Settings → Media → Library → Videos → Add Source.
- Only add folders that contain child-appropriate content.
Step 3: Install Kid-Friendly Add-ons
- In the child profile, only install add-ons that are suitable for children.
Step 4: Choose a Kid-Friendly Skin (Optional)
- Consider installing a simple, colorful skin that’s easy for children to navigate.
Part 4: Live TV Parental Controls (Optional)
If you use Kodi with a PVR backend for live TV, you can lock specific channels:
Step 1: Go to Settings → PVR & Live TV → Parental Controls
Step 2: Toggle “Enable” to ON and set a PIN.
Step 3: In the Channel Manager, mark individual channels as “locked.”
Note: This feature requires your PVR backend (e.g., Tvheadend, NextPVR) to support parental controls.
Part 5: Smart Playlists for Content Filtering (Advanced)
For even finer control, you can use Smart Playlists to filter content by rating:
Step 1: Go to Videos → Playlists.
Step 2: Select “New Smart Playlist” .
Step 3: Set rules based on MPAA rating (e.g., only G, PG, PG-13).
🎮 What to Expect – Post-Setup Walkthrough
After setting up parental controls, here’s what your Kodi experience will look like:
- Login Screen: When Kodi starts, users must select a profile. The child profile will only show approved content.
- Locked Sections: Attempting to access locked areas (Settings, Add-ons, File Manager) will prompt for the Master Lock PIN.
- Restricted Live TV: Locked channels won’t appear in the EPG or play without the PIN.
- Separate Watch History: Each profile maintains its own watch history, resume points, and favorites.
⚠️ Known Limitation: In the default Estuary skin, the Master Lock may not fully block access to “Recently Viewed” items from the main menu.
🧰 Troubleshooting – How to Fix Common Kodi Parental Control Errors
🔑 I forgot my Master Lock PIN – how do I reset it?
This is the most common issue. The Master Lock code is stored in the profiles.xml file in your Kodi userdata folder.
Method 1 – Delete the file (easiest):
- Locate your Kodi
userdatafolder:- Windows:
%APPDATA%\Kodi\userdata\ - macOS:
~/Library/Application Support/Kodi/userdata/ - Android:
Android/data/org.xbmc.kodi/files/.kodi/userdata/ - LibreELEC/OSMC: Access via network share or SSH at
storage/.kodi/userdata/
- Windows:
- Delete the
profiles.xmlfile. - Restart Kodi – a new file without a PIN will be generated automatically.
Method 2 – Edit the file:
- Open
profiles.xmlin a text editor. - Find the
<masterlock>tag and remove or reset the PIN information. - Save and restart Kodi.
For LibreELEC users: You must stop the Kodi service before editing:
systemctl stop kodi
# edit/delete profiles.xml
systemctl start kodi
⚠️ Important: On some systems, deleting profiles.xml may not work if the system automatically restores it from a backup. In that case, you must stop the Kodi service first as shown above.
🔒 Master Lock doesn’t block everything – why?
The Master Lock protects the Kodi interface but has limitations:
- It will not protect content and settings files from being accessed via the operating system.
- It may be bypassed via the web interface or certain add-ons.
- In the default Estuary skin, direct access to “Recently Viewed” items from the main menu may still work without a PIN.
Solution: Use Profiles (not just Master Lock) to create a completely separate environment for children, and only add approved content sources to their profile.
📱 Kodi crashes when I launch the child profile on Android TV
This is a known permission issue. When Kodi starts for the first time, it asks to enable “Allow access to manage all files.”
Solution:
- Log into the Master User profile first.
- Grant the permission when prompted.
- Then switch to the child profile – it should now work without crashing.
📺 Live TV parental controls are grayed out – why?
The Live TV parental control option requires your PVR backend (e.g., Tvheadend, NextPVR) to support parental controls. If the backend doesn’t support it, the Kodi option will remain disabled.
👶 How do I limit daily screen time on Kodi?
Install the Wellbeing add-on from the official Kodi repository:
- Go to Add-ons → Download → Services.
- Find and install “Wellbeing”.
- Configure daily time limits – playback will automatically stop when the limit is reached.
🔄 My child profile still shows adult content – what now?
Double-check your configuration:
- Make sure you’re logged into the child profile when adding media sources.
- Only add approved folders – do not add your entire media library.
- Use Smart Playlists to filter by MPAA rating (G, PG, PG-13).
- Consider using tags to categorize content (e.g., “Adult,” “Teen+,” “Kids”) and restrict profiles accordingly.
🔒 Safety & Privacy – What Else You Should Know
Kodi Itself Is Legal: Kodi is a legitimate, open-source media player. The legality concerns arise only when you install third-party add-ons that access copyrighted content without permission.
Use a VPN: If you use third-party add-ons, your IP address is exposed to whoever hosts the streams. A VPN encrypts your traffic and hides your online activity from your ISP.
Stick to Official Sources: Only download add-ons from the official Kodi repository or trusted sources like the Kodi Community Forum. Unknown repositories may contain malware or trackers.
❓ Frequently Asked Questions
Does Kodi have built-in parental controls?
Yes! Kodi includes Profiles, Master Lock, and Live TV parental controls – all built-in and ready to use.What’s the difference between Profiles and Master Lock?
Profiles create completely separate Kodi environments for different users (different libraries, settings, add-ons). Master Lock applies a PIN to specific sections of Kodi (Settings, Add-ons, File Manager, etc.) within a profile.Can I use parental controls on all Kodi versions?
Yes, parental controls work on Kodi 20 “Nexus,” Kodi 21 “Omega,” and the upcoming Kodi 22 “Piers.”Will parental controls work with third-party add-ons?
The Master Lock can lock the Add-ons Manager, preventing installation or uninstallation. However, it cannot filter content within third-party add-ons – you must use Profiles to restrict which add-ons are available.Can I set different PINs for different profiles?
Yes! Master Lock settings are profile-specific. Log into each profile and set a different PIN.Does Kodi have age-based content filtering?
Kodi doesn’t have a global age-rating filter, but you can achieve this using: Smart Playlists filtered by MPAA rating Tags to categorize content Separate Profiles with different media sourcesIs Kodi safe for kids?
With proper parental controls configured (Profiles + Master Lock + approved media sources), Kodi can be a safe media center for children. However, always supervise and regularly check the content available in their profile.💎 Summary – Best Practices for Kodi Parental Controls
| Feature | Purpose | Recommendation |
|---|---|---|
| Profiles | Create separate environments | ⭐⭐⭐⭐⭐ Essential – always use this |
| Master Lock | PIN-protect settings and add-ons | ⭐⭐⭐⭐⭐ Essential – always use this |
| Smart Playlists | Filter content by rating | ⭐⭐⭐⭐ Highly recommended |
| Live TV PIN | Lock specific channels | ⭐⭐⭐ If you use live TV |
| Wellbeing Add-on | Limit daily screen time | ⭐⭐⭐ For managing screen time |
| VPN | Protect privacy | ⭐⭐⭐⭐⭐ If using third-party add-ons |
Recommended Setup Strategy:
- Create a Child Profile – Only add approved media sources and kid-friendly add-ons.
- Enable Master Lock – PIN-protect Settings, Add-ons Manager, and File Manager.
- Enable Login Screen – Ensures users select their profile at startup.
- (Optional) Use Smart Playlists – Filter by MPAA rating for extra safety.
- (Optional) Install Wellbeing – Set daily time limits.
- Use a VPN – If you use any third-party add-ons, protect your privacy.






