Selenium Manager

Introduction

Managing browser drivers has always been one of the biggest challenges in Selenium automation. In earlier versions of Selenium, testers had to manually download browser drivers such as ChromeDriver, EdgeDriver, or GeckoDriver and keep them updated whenever the browser version changed.

To simplify this process, Selenium 4.6 introduced Selenium Manager, a built-in tool that automatically downloads, configures, and manages browser drivers.

With Selenium Manager, you no longer need to manually download or configure browser drivers in most situations. It detects the installed browser, finds the appropriate driver version, downloads it automatically, and uses it during test execution.

In this tutorial, you’ll learn what Selenium Manager is, how it works, its advantages, limitations, and how to use it in Selenium with Python.


What is Selenium Manager?

Selenium Manager is a built-in driver management tool introduced in Selenium 4.6.

It automatically:

  • Detects installed browsers

  • Finds the compatible browser driver

  • Downloads the required driver

  • Configures the driver automatically

  • Uses the driver to launch the browser

This eliminates the need for manually downloading browser drivers in most Selenium projects.


Why was Selenium Manager Introduced?

Before Selenium Manager, automation engineers had to:

  • Download browser drivers manually

  • Keep browser drivers updated

  • Configure system PATH variables

  • Resolve browser-driver compatibility issues

These tasks consumed time and often caused test failures.

Selenium Manager automates these activities, making Selenium setup much simpler.


How Selenium Manager Works

The workflow is:

Python Script
       │
       ▼
Selenium WebDriver
       │
       ▼
Selenium Manager
       │
       ▼
Detect Installed Browser
       │
       ▼
Download Compatible Driver
       │
       ▼
Launch Browser

When your Selenium script starts:

  1. Selenium checks whether a compatible browser driver is available.

  2. Selenium Manager detects the installed browser version.

  3. It downloads the appropriate browser driver if required.

  4. The browser is launched automatically.

  5. Your automation script continues normally.


Supported Browsers

Selenium Manager supports all major browsers.

  • Google Chrome

  • Microsoft Edge

  • Mozilla Firefox

Safari uses the built-in SafariDriver provided by macOS and generally does not require Selenium Manager.


Using Selenium Manager

One of the biggest advantages of Selenium Manager is that no additional configuration is required.

Simply write your Selenium code.

Example: Launch Google Chrome

from selenium import webdriver

driver = webdriver.Chrome()

driver.get("https://example.com")

print(driver.title)

driver.quit()

Output

Example Domain

No ChromeDriver download or PATH configuration is required.


Example: Launch Firefox

from selenium import webdriver

driver = webdriver.Firefox()

driver.get("https://example.com")

print(driver.title)

driver.quit()

Output

Example Domain

Selenium Manager automatically manages GeckoDriver.


Example: Launch Microsoft Edge

from selenium import webdriver

driver = webdriver.Edge()

driver.get("https://example.com")

print(driver.title)

driver.quit()

Output

Example Domain

EdgeDriver is downloaded and managed automatically.


Requirements

To use Selenium Manager, ensure:

  • Selenium version 4.6 or later

  • Python installed

  • Internet connection (required the first time a driver is downloaded)

  • Supported browser installed

Install or upgrade Selenium using:

pip install --upgrade selenium

Advantages of Selenium Manager

Selenium Manager offers several benefits:

  • No manual browser driver downloads

  • Automatically detects installed browsers

  • Downloads compatible browser drivers

  • Eliminates PATH configuration

  • Reduces browser compatibility issues

  • Simplifies Selenium project setup

  • Saves development and maintenance time


Limitations of Selenium Manager

Although Selenium Manager is very useful, there are some limitations.

  • Internet connection is required the first time a driver is downloaded.

  • Some enterprise environments with restricted internet access may require manual driver management.

  • Older Selenium versions do not support Selenium Manager.

  • Organizations with strict security policies may prefer manually managed drivers.


Selenium Manager vs Manual Driver Management

Selenium ManagerManual Driver Management
Automatic driver downloadManual driver download
No PATH configurationPATH configuration required
Detects browser version automaticallyUser must manage compatibility
Easy setupMore configuration required
Recommended for modern Selenium projectsMainly used in restricted environments

Common Issues

Browser Not Installed

Cause

The required browser is not available on the system.

Solution

Install the browser before running the Selenium script.


Internet Not Available

Cause

Selenium Manager cannot download the required browser driver.

Solution

Connect to the internet or configure the browser driver manually.


Using an Older Selenium Version

Cause

Selenium Manager is available only in Selenium 4.6 and later.

Solution

Upgrade Selenium.

pip install --upgrade selenium

Best Practices

  • Use the latest stable version of Selenium.

  • Prefer Selenium Manager over manual browser driver management.

  • Keep browsers updated to stable releases.

  • Ensure internet access during the initial driver download.

  • Use Selenium Manager for new Selenium automation projects whenever possible.


Frequently Asked Questions (FAQs)

What is Selenium Manager?

Selenium Manager is a built-in tool that automatically downloads and manages browser drivers for Selenium.


Which Selenium version introduced Selenium Manager?

Selenium Manager was introduced in Selenium 4.6.


Do I still need ChromeDriver?

In most cases, no. Selenium Manager automatically downloads and manages ChromeDriver for you.


Does Selenium Manager support all browsers?

It supports major browsers such as Google Chrome, Microsoft Edge, and Mozilla Firefox. Safari uses the built-in SafariDriver on macOS.


Is Selenium Manager recommended for new projects?

Yes. Selenium Manager is the recommended approach for modern Selenium automation projects because it simplifies browser driver management.


Key Takeaways

  • Selenium Manager is a built-in browser driver management tool introduced in Selenium 4.6.

  • It automatically detects browsers, downloads compatible drivers, and configures them.

  • It removes the need for manually downloading and managing browser drivers in most cases.

  • Selenium Manager simplifies Selenium project setup and reduces compatibility issues.

  • It is the recommended approach for modern Selenium with Python automation projects.

  • Understanding Selenium Manager is essential for working with the latest versions of Selenium.