Registry /
testing / robotframework-seleniumlibrary
Install & Compatibility
Where this runs
tested against v6.9.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 62.1MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.2s · import 0.000s · 63MB
62MB installed
● package 62MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
SeleniumLibrary
✓ *** Settings ***
Library SeleniumLibrary
✗ from robotframework.libraries import SeleniumLibrary
SeleniumLibrary is a Robot Framework library, imported directly in the settings section of a .robot file, not as a Python module in Python code.
This Robot Framework example demonstrates a basic login test using SeleniumLibrary. It opens a Chrome browser, navigates to a login page, inputs text into username and password fields, clicks the login button, asserts a successful login message, and then closes the browser. Replace `${USERNAME_HERE}` and `${PASSWORD_HERE}` with actual credentials or variables.
*** Settings ***
Library SeleniumLibrary
*** Test Cases ***
Example Login Test
Open Browser https://the-internet.herokuapp.com/login browser=chrome
Input Text id=username ${USERNAME_HERE}
Input Text id=password ${PASSWORD_HERE}
Click Button css:button[type='submit']
Element Should Contain id=flash You logged into a secure area!
Close Browser
Debug
Known issues
breakingSeleniumLibrary version 6.0.0 and newer requires Selenium WebDriver 4.x+. Older versions of Selenium are no longer supported.fixEnsure your `selenium` package is updated to version 4.x or newer (e.g., `pip install --upgrade selenium`).
affects: >=6.0.0
deprecatedThe `headlesschrome` and `headlessfirefox` browser options for `Open Browser` were deprecated and removed in v6.2.0. Headless mode should now be configured using Selenium options directly.fixUse the `options` argument with Selenium's `Options` object (e.g., `options=chromeoptions:add_argument(--headless)`).
affects: >=6.2.0
gotchaSeleniumLibrary v6.1.1 fixed an incompatibility with Selenium v4.10.0+ where certain deprecated Selenium code paths were removed, causing issues for the library.fixUpgrade SeleniumLibrary to v6.1.1 or newer to ensure compatibility with recent Selenium versions.
affects: 6.1.0 (with Selenium >=4.10.0)
gotchaVersion 6.7.1 downgraded the requirement on the `click` dependency to `click>=8.0` to address installation issues in some environments.fixIf experiencing dependency resolution issues with `click`, ensure you are on SeleniumLibrary 6.7.1 or newer. You might need to manually downgrade `click` if an incompatible version was installed.
affects: 6.7.0 (potentially)
breakingPython 2 support was dropped prior to SeleniumLibrary 4.0. All modern versions require Python 3.8+.fixMigrate your test environment and Robot Framework setup to Python 3.8 or newer.
affects: <4.0 (for Python 2 users)
breakingPrior to version 3.0, the library was known as `Selenium2Library`. Migrating to `SeleniumLibrary` requires changing the import statement (`Library Selenium2Library` to `Library SeleniumLibrary`) and potentially updating keyword calls if prefixed.fixUpdate library imports in your Robot Framework `*** Settings ***` and ensure keyword calls reflect the new library name. Refer to migration guides for details.
affects: <3.0 (for `Selenium2Library` users)
Upgrade
Version history
6.9.0latest on PyPI · released May 17, 2026
Audit
Dependencies
seleniumrequiredCore dependency for browser automation. Requires Selenium 4.x+
robotframeworkrequiredCore dependency for running tests. Requires Robot Framework 6.1.1+ (or 7.x)
clickoptionalInternal command-line utility dependency, specific version range fixes applied.