How to Fix “Python is not recognized” in Windows 11 (Step-by-Step Guide)

This is, without a doubt, a common issue that many beginner programmers have encountered: “’python’ is not recognized as an internal or external command, operable program or batch file.” It happens for a simple reason: Windows does not know which folder contains the python.exe file.

When you type python in the Command Prompt (CMD) or PowerShell, Windows searches through a list of directories called Environment Variables. If your Python installation location is not on this list, the system returns the unrecognized command error.

Follow the steps below to fix it.

---

1. Locate where Python is installed

First, we need to find the exact installation address. If you installed Python using the default installer from the official website, it is usually located in a hidden folder.

1. Press the Win + R keys, type %AppData%, and hit Enter.
2. The Roaming folder will open. Go back one folder level to reach the Local folder.
3. Navigate through the following path: Programs > Python > Python3x (where 3x is your version, such as Python312).
4. Important: Copy the path that appears in the File Explorer address bar (e.g., C:\Users\YourName\AppData\Local\Programs\Python\Python312).
5. Also, save the path to the Scripts folder, which is located inside that same Python folder. You will need both.

---

2. Open System Environment Variables

Now that we have the addresses, we need to register them in Windows 11.

1. Click the Start menu and type “Environment variables”.
2. Select the option “Edit the system environment variables”.
3. In the window that opens (System Properties), click the Environment Variables button at the bottom of the Advanced tab.

---

3. Configure the PATH

We will focus on User variables, which only affect your profile and are safer to modify.

1. In the top section (User variables for [YourName]), locate the variable named Path and click Edit.
2. In the new window, click the New button.
3. Paste the first path you copied (the main Python folder).
4. Click New again and paste the second path (the Scripts folder).
5. Click OK to close the Path editing window.
6. Click OK in the Environment Variables window and OK in the System Properties window.

---

4. Restart the Terminal

Changes to Environment Variables are not applied to terminal windows that are already open.

1. Close any open instances of CMD or PowerShell.
2. Open a new Command Prompt (or Windows Terminal).
3. Type the following command and press Enter:DOSpython --version
4. If the system returns something like Python 3.x.x, the error has been corrected.

---

Alternative: Fix via Installer

If you prefer not to manually edit system variables, you can use the installer to handle the process:

1. Run the Python installer you downloaded from the official website (or download it again).
2. On the initial screen, select the Modify option.
3. Click Next on the optional features screen.
4. On the Advanced Options screen, check the box “Add Python to environment variables”.
5. Click Install or Modify. The installer will attempt to register the paths in the PATH for you.

---

Conclusion

Solving the “Python is not recognized” problem is an essential step in setting up your environment. By adding the Python and Scripts folders to the Windows 11 PATH, you ensure that the compiler works along with essential tools like pip.

Your operating system now knows exactly where to look for the necessary executables whenever you invoke a Python-related command.

---

FAQ