Skip to main content

Python Selenium: How to Resolve "WebDriverException: Message: 'chromedriver' executable needs to be in PATH'"

When using Selenium to automate the Google Chrome browser, you might encounter the WebDriverException: Message: 'chromedriver' executable needs to be in PATH. This error means that Selenium, your Python script, cannot find the necessary "bridge" program—the ChromeDriver—that it needs to communicate with and control the Chrome browser.

Prior to Selenium 4, developers had to manually download and manage this driver. However, modern versions of Selenium have automated this process. This guide will cover the recommended modern solution first, followed by older methods for legacy projects.

Understanding the Error: The Role of ChromeDriver​

Selenium does not interact with the Chrome browser directly. It requires a separate, version-specific executable called ChromeDriver to act as a proxy. Your Selenium script sends commands to ChromeDriver, which then translates them into actions that the Chrome browser understands.

The ...needs to be in PATH error means that Selenium searched all the directories listed in your system's PATH environment variable but could not find the chromedriver executable.

Reproducing the WebDriverException​

On an older Selenium installation (version 3.x), running the following code without a manually configured ChromeDriver will trigger the error.

Example of code causing the error:

from selenium import webdriver

# On Selenium 3, this will fail if chromedriver is not in the PATH.
driver = webdriver.Chrome()

Output:

Traceback (most recent call last):
  File "main.py", line 1, in <module>
    from selenium import webdriver
ModuleNotFoundError: No module named 'selenium'

Solution 1: Upgrade to Selenium 4.6.0+ (Best Practice)​

Starting with version 4.6.0, Selenium includes a new feature called Selenium Manager. This tool automatically detects your Chrome browser version, downloads the correct ChromeDriver, and manages it for you. This is the official and most convenient solution.

Step 1: Upgrade your Selenium library

pip install --upgrade selenium

Step 2: Run your code without any changes The same simple code now works without any manual setup.

from selenium import webdriver
from selenium.webdriver.chrome.service import Service

# This now works automatically! Selenium Manager handles the driver.
driver = webdriver.Chrome()

driver.get("https://www.selenium.dev/documentation/")
print(f"Page title is: {driver.title}")
driver.quit()

Output:

Page title is: The Selenium Browser Automation Project | Selenium
note

Upgrading to the latest version of Selenium is the recommended approach for all new and existing projects, as it completely eliminates the need for manual driver management.

Solution 2: Use webdriver-manager (For Older Selenium Versions)​

If you are stuck on an older version of Selenium (3.x or early 4.x) and cannot upgrade, the webdriver-manager package provides a similar automatic management solution.

Step 1: Install webdriver-manager

pip install webdriver-manager

Step 2: Modify your code to use ChromeDriverManager This tool will download the driver if it's missing and provide the path to its executable for Selenium to use.

from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager

# This will download the correct driver and pass its path to Selenium.
service = Service(ChromeDriverManager().install())
driver = webdriver.Chrome(service=service)

driver.get("https://pypi.org/project/webdriver-manager/")
print(f"Page title is: {driver.title}")
driver.quit()

Output:

Page title is: webdriver-manager · PyPI

This is the old, manual method and should be avoided unless absolutely necessary. It requires you to keep your ChromeDriver in sync with your Chrome browser version, which can be a frequent and tedious task.

Solution:

  1. Check your Chrome browser version by going to chrome://settings/help.
  2. Go to the ChromeDriver downloads page and download the zip file that matches your browser version.
  3. Unzip the file to get the chromedriver (or chromedriver.exe) executable.
  4. Place the executable in a directory that is on your system's PATH. Common locations include /usr/local/bin on macOS/Linux. On Windows, you can add a new folder (e.g., C:\WebDriver) to your system's PATH environment variable and place the executable there.
  5. Restart your terminal for the PATH changes to take effect.
warning

This method is very brittle. Every time your Chrome browser auto-updates, you will likely need to download a new ChromeDriver, making this a poor choice for long-term projects.

Conclusion​

Your SituationRecommended Solution
Starting a new project or can upgrade dependencies.Upgrade to Selenium 4.6.0+ (pip install --upgrade selenium). Selenium Manager handles everything automatically.
Using an older Selenium version and cannot upgrade.Use the webdriver-manager package to automate driver downloads.
In a restricted environment with no other choice.Manually download the matching ChromeDriver and place it in your system's PATH.

For modern, hassle-free web automation with Selenium, upgrading to the latest version is the definitive solution to the ...chromedriver executable needs to be in PATH error.

Table of Contents