Home / Fixes / Python Fixes / Installation, PATH & Commands / Python Installed but IDLE Is Missing — How to Restore or Install IDLE
IDLE recovery

Python Installed but IDLE Is Missing — How to Restore or Install IDLE

Python works but IDLE vanished? First separate a missing IDLE component from a missing shortcut, because reinstalling Python for a shortcut problem is overkill.

By Rohith BijuUpdated 10 Aug 2026 WindowsIDLE missingTcl/TkShortcut diagnosis
Fast diagnosis

Test whether IDLE exists but the shortcut is missing

Launch IDLE through the same Python interpreter instead of using Start menu search.

python -m idlelib

If IDLE opens, the program files are present. Your issue is shortcut/discovery, not a missing IDLE component.

Testpython -m idlelib
If opensShortcut issue
If failsFeature/version check
Version check

Make sure you are testing the intended Python installation

python --version
python -c "import sys; print(sys.executable)"
where.exe python

On PCs with multiple Python versions, the python command may point to a different installation than the one whose IDLE entry you expected.

Classic installer

Restore Tcl/Tk and IDLE for traditional installer versions

The traditional Windows installer includes Tcl/Tk and IDLE as an optional feature. Open Installed apps, select the relevant Python version, and use Modify when available to ensure the Tcl/Tk/IDLE component is installed.

Do not install a second unrelated Python version solely to get an IDLE shortcut.

Shortcut only

If IDLE opens from terminal but Start menu cannot find it

The installation itself is healthy. You can continue using python -m idlelib and repair/create a user shortcut that clearly points to the intended version.

IDLE health check

Confirm which Python IDLE is using

Inside the IDLE Shell, run:

import sys
print(sys.version)
print(sys.executable)

The executable should match the Python runtime you intend to use.

Component check

Test whether Tcl/Tk is available

IDLE uses Tkinter for its graphical interface. If python -m idlelib fails, test Tkinter separately to distinguish a missing GUI component from a shortcut issue.

python -c "import tkinter; print(tkinter.TkVersion)"

If this import fails on a traditional Windows installation, use the installer maintenance options to add the Tcl/Tk and IDLE feature. If Tkinter works but IDLE still does not launch, capture the actual traceback rather than reinstalling blindly.

Multiple versions

If several Python versions are installed, launch IDLE from the exact interpreter

A Start-menu entry can hide which runtime it belongs to. When you are testing a multi-version machine, use the interpreter path or version-selection method you already verified, then launch idlelib from that runtime. This prevents repairing Python 3.12 because an IDLE shortcut actually belonged to Python 3.13.

After IDLE opens, the sys.executable check inside its Shell is the final proof of which installation you are editing and running code with.

Read the result

What the IDLE test tells you

  • IDLE opens: the installation contains IDLE. Repair only the shortcut or Windows Search discovery.
  • No module named idlelib: that specific Python distribution does not include IDLE, or the component is missing. Modify the matching classic CPython installation or use the distributor’s supported package method.
  • Tkinter or Tcl/Tk error: IDLE is present but its GUI dependency is unavailable or damaged. Test tkinter, then repair the GUI component for the same interpreter.
  • A different Python path appears: select the intended runtime first; repairing another installation will not restore this one’s IDLE.

IDLE is an optional module in CPython distributions, so a missing IDLE entry does not automatically mean the interpreter itself is broken.

FAQ checkpoint

Frequently asked questions

Is IDLE installed with Python?

Normal CPython desktop installer workflows can include IDLE with Tcl/Tk support. Installer options and distributions vary, so test python -m idlelib first.

Why does one Python version have IDLE and another not?

Each installation is separate and can have different optional components or shortcuts.

Do I need IDLE to use Python?

No. Python can run from terminals, VS Code, PyCharm, notebooks and other editors.

Next mission

Related Python fixes

Continue with the page that matches the symptom you see after this step.

Fix missing Start-menu shortcuts →Repair broken Python →
Reference log

References

Installation behavior and commands were checked against current Python documentation on 10 August 2026.