How-to guide
Chrome Extension for Selenium: Record Tests, Then Know When to Write Code
How-to
Chrome Extension for Selenium: Record Tests, Then Know When to Write Code
On this page
- The short answer
- What is the Chrome extension for Selenium?
- How do I install Selenium IDE and record a test?
- What can Selenium IDE do, and where does it stop?
- When should I move from record and playback to code?
- How do I set up Selenium WebDriver with Chrome?
- Which Chrome extensions help testers alongside Selenium?
- How do I handle cookies and logged-in sessions when testing?
- How do I test different browsers, user agents and screen sizes?
- Why does my recorded Selenium test fail or behave differently?
- Frequently asked
The short answer
The Chrome extension for Selenium is Selenium IDE, the official record-and-playback tool from the Selenium project. Install it from the Chrome Web Store, record clicks and typing, then replay them. When tests need loops, data or CI, export to code and use WebDriver with ChromeDriver.
What is the Chrome extension for Selenium?
It is Selenium IDE, an official extension maintained by the Selenium project that records what you do in the browser and replays it as an automated test. The project site lists it on the Chrome Web Store (official listing), and its documentation lives at selenium.dev/selenium-ide.
We do not have a Selenium IDE profile in our directory, so we link its official pages instead. From our catalogue, Katalon Recorder is the closest record-and-replay alternative, with a caveat covered below. Later sections cover the extensions testers use around either tool: cookie editors, user agent switchers, window resizers and inspectors.
Two names cause confusion. Selenium IDE is the extension you click. Selenium WebDriver is the programming library that drives a browser from code, using a driver such as ChromeDriver. The extension is the gentle on-ramp; WebDriver is where most professional suites end up.
- Selenium IDE
- Browser extension. Record, edit and replay tests in a visual editor. Good for quick checks and learning.
- Selenium WebDriver
- Code library for Java, Python, JavaScript, C# and more. Good for large, versioned test suites.
- ChromeDriver
- The bridge that lets WebDriver control Chrome. Its documentation is on developer.chrome.com.
One more point: an extension cannot replace a driver for cross-browser or headless runs in a build server. That is the line between record and playback and real automation.
How do I install Selenium IDE and record a test?
Add it from the Chrome Web Store, open it from the toolbar, and press record. You can have a first test replaying in a few minutes.
- Open the Selenium IDE listing linked from selenium.dev/selenium-ide (Chrome Web Store ID
mooikfkahbdckldjjndioackbalphokd), then click Add to Chrome. - Click the puzzle-piece Extensions icon and pin Selenium IDE.
- Click its icon. The welcome dialog offers Record a new test in a new project, Open an existing project, Create a new project and Close the IDE; choose the first.
- Name the project, then enter the base URL, which is the URL of the application you are testing. A new browser window opens on that URL and starts capturing.
- Click through your flow, such as opening a login page, typing details and pressing Sign in. Each action appears as a command.
- Switch back to the IDE window and click the recording icon to stop, then select your test and click the play button in the menu bar to replay it.
Each row in the editor holds a command, a target and a value. The target is a locator such as an id or CSS selector, and the value is what to type. You can edit any row after recording.
Add assertions while you record
A test that only clicks proves nothing. Add assert commands after the action to check that text, a title or an element exists. Without assertions a broken page can still pass.
Click the save icon at the top right of the IDE to save the project as a single .side file you can reopen or hand to a colleague.
What can Selenium IDE do, and where does it stop?
It handles simple, linear flows well and starts to strain once tests need real logic, shared data or heavy maintenance. Knowing the limits saves you from building a large suite on a tool meant for small ones.
| Task | Selenium IDE | Code with WebDriver |
|---|---|---|
| Record a login and check the dashboard | Fits well | Works, more setup |
| Replay in the browser you are using | Yes | Yes |
| Run on a build server with no screen | Needs the command-line runner | Native, headless supported |
| Loops and conditions | Basic control-flow commands | Full language features |
| Large data sets | Awkward | Read from files or databases |
| Shared helper functions and page objects | Limited | Standard practice |
| Code review and version control | .side project files are harder to review than plain code | Plain code, easy diffs |
Selenium IDE also has a command-line runner, installed with npm install -g selenium-side-runner and started with selenium-side-runner /path/to/project.side. It needs Node.js and a browser driver such as chromedriver. That helps a small team run recorded checks in a pipeline, though you still depend on the recording staying correct. The runner documentation has the current options.
Recorded locators can be fragile
The recorder picks a locator for each element and sometimes chooses one tied to page layout. When the design changes, the test breaks. Editing a locator to a stable id or data attribute is the most useful habit for keeping recordings alive.
When should I move from record and playback to code?
Move to code once you are copying and pasting steps between tests, or when a test must run unattended on every commit. Those are signs the recording has outgrown the extension.
- You repeat the same login steps in ten tests and want one shared function.
- You need to run tests against several browsers or in headless mode.
- Tests must read test data from a file, API or database.
- A failing test needs proper logs, screenshots and retries.
- Several people edit the tests and need pull requests and history.
- You want to combine UI checks with API calls or database setup.
You do not have to throw the recording away. Selenium IDE can export a test to code: its code export docs list C# NUnit and xUnit, Java JUnit, JavaScript Mocha, Python pytest and Ruby RSpec. Right-click a test or suite, choose Export, pick a language and click Export. Treat the exported file as a draft to refactor, not a finished suite.
Some teams choose a different framework instead of Selenium. Playwright, for example, ships a code generator described at playwright.dev/docs/codegen. Which tool suits you depends on languages, browsers and what your team already knows.
If your goal is broader automation, such as filling forms or repeating clicks for yourself rather than testing, look at the automation category instead.
How do I set up Selenium WebDriver with Chrome?
Install the Selenium library for your language and let it locate ChromeDriver. Since Selenium 4.6, releases ship with Selenium Manager, which acts as a fallback to find and download a matching driver automatically when you do not provide one.
- Install Python and run
pip install seleniumin a terminal, or choose the equivalent package for Java, JavaScript or C#. - Make sure Chrome is installed and up to date.
- Create a file with the short script below.
- Run it. Chrome opens, loads the page and closes.
from selenium import webdriver
from selenium.webdriver.common.by import By
driver = webdriver.Chrome()
driver.get("https://example.com")
print(driver.title)
link = driver.find_element(By.TAG_NAME, "a")
print(link.text)
driver.quit()If Chrome fails to start, the usual cause is a version mismatch between the browser and the driver. Check the ChromeDriver documentation and the Selenium documentation for the current setup steps, since details change between releases.
Do not automate accounts you do not own
Automated logins, scraping and clicking may break a site's terms of service. Test your own applications or staging environments, and check the rules before pointing a script at anyone else's site.
Which Chrome extensions help testers alongside Selenium?
Katalon Recorder is the one recorder here. The rest do not record or replay tests; they help you inspect, reproduce and debug what your tests find. Pair them with the tool of your choice from the developer tools category.
Extensions for inspecting and debugging while you test
-
Katalon Recorder (Selenium tests generator)Free
Developer Tools
Records and replays browser actions and exports Selenium test scripts; the listing calls it a free alternative to Selenium IDE. Catch: the listing says it is no longer actively maintained, with no further updates or security patches planned, so treat it as a stopgap.
-
WappalyzerFreemium
Developer Tools
Shows the tech stack behind a site, useful when planning locators for framework-rendered pages. Freemium, so some features may need an account.
-
JSON FormatterFree
Developer Tools
Pretty-prints JSON responses so you can read API output in a tab. Catch: it only formats, it does not validate against a schema.
-
Developer Tools
Inspects React component trees and props, which helps you find why an element renders as it does. Only useful on React apps.
-
Clear CacheFree
Developer Tools
Clears cache and cookies in one click to reset state between manual runs. Catch: it does not change the state of an automated browser profile.
-
Window ResizerFree
Developer Tools
Snaps the window to preset sizes for quick responsive checks before you script them.
-
Developer Tools
Shows unread GitHub notifications, handy for spotting CI and pull request activity. It does not run tests itself.
For a wider list of tools that suit programmers, see the developers hub.
How do I test different browsers, user agents and screen sizes?
For quick manual checks, switch the user agent and resize the window before you write a test. That tells you whether the page reacts, and which cases deserve automation.
- Install a user agent switcher and choose a mobile or alternate browser string.
- Reload the page and confirm it serves the layout you expect.
- Use a window resizer to snap to common widths.
- Note the breakpoints where the layout changes, then repeat them in a scripted test.
User agent switchers
-
Developer Tools
Spoof and mimic browser strings on any site with one click. Catch: sites that check more than the string may still detect the real browser.
-
Developer Tools
Manages and rotates custom profiles, useful for repeating the same checks with several strings.
-
Developer Tools
Changes the user agent across sites you visit. Broad reach, so apply it deliberately and reset it afterwards.
Remember that changing the user agent changes only a header. It does not emulate a phone's screen, touch input or performance. For those, use Chrome DevTools device mode or a real device.
You can also use our free webcam test, keyboard tester and mic test to rule out hardware problems before blaming your test script.
Why does my recorded Selenium test fail or behave differently?
Most failures come from timing, unstable locators or environment differences rather than from Selenium itself. Fix those three and most recordings settle down.
- Element not found: the page had not finished loading. Add a wait command for the element instead of a fixed pause.
- Wrong element clicked: the recorded locator matches several elements. Replace it with an id or a specific CSS selector.
- Works once, fails on replay: leftover state, such as a logged-in session or filled form. Clear cookies or start a fresh profile.
- Different results on the CI machine: the window size, browser version or locale differs from your laptop.
- Pop-ups and extensions interfere: an ad blocker or consent banner changes the page. Use a clean profile, and check for blockers with our ad block test.
- Timing-sensitive input: actions that depend on speed, like repeated clicks, may behave differently. The CPS test shows how fast you click by hand.
Use a clean browser profile for automation
Extensions installed for daily browsing can change a page during tests. Run automated tests in a dedicated profile that holds only what the test needs.
Network checks matter too. If a test depends on a VPN or proxy, confirm your traffic goes where you expect with the WebRTC leak test. For research-focused tools, our AI tools for researchers list is a different angle.
Extensions mentioned in this guide
- Katalon Recorder (Selenium tests generator)Records and replays browser actions and exports Selenium test scripts
- WappalyzerSee the tech stack behind any website.
- JSON FormatterPretty-print JSON right in the browser.
- React Developer ToolsInspect React component trees and props.
- Clear CacheClear cache and cookies in one click.
- Cookie-EditorView, edit, create, and delete browser cookies for any site right from the toolbar
- Window ResizerSnap the browser window to preset or custom sizes for side-by-side viewing.
- User-Agent SwitcherSpoof and mimic browser user-agent strings on any site with one click
Frequently asked
What is the best Chrome extension for Selenium?
Selenium IDE, the official record-and-playback extension from the Selenium project. It is the only one that records and replays tests.
Is Selenium IDE free?
Yes, Selenium IDE is open source and free to use. Check the Chrome Web Store listing and selenium.dev for the current details.
How do I add Selenium to Chrome?
Install Selenium IDE from the Chrome Web Store for record and playback. For code-based testing, install the Selenium library for your language and use ChromeDriver.
Can Selenium IDE export to Python or Java?
Yes. Right-click a test or suite and choose Export. Supported targets include Python pytest, Java JUnit, JavaScript Mocha, C# NUnit and xUnit, and Ruby RSpec. Treat the output as a draft to refactor.
What is the difference between Selenium IDE and WebDriver?
Selenium IDE is a browser extension for recording tests. WebDriver is a programming library that controls a browser from code and suits larger suites.
Do I need ChromeDriver to use Selenium IDE?
No. The extension runs inside your browser. You need ChromeDriver only when you use WebDriver from code or run tests outside the extension.
How do I run Selenium IDE tests from the command line?
Install it with npm install -g selenium-side-runner, then run selenium-side-runner followed by the path to your .side file. You also need Node.js and a browser driver such as chromedriver.
Which Chrome extensions do QA testers use?
Common picks include Wappalyzer, JSON Formatter, cookie editors, user agent switchers and window resizers. They inspect and debug rather than automate.
Why does Selenium say it cannot find an element?
The page usually had not finished loading, or the locator is unstable. Add an explicit wait and use an id or specific selector.
Is Selenium IDE good enough for professional testing?
It suits quick checks and learning. Teams with large suites, data-driven tests and CI usually move to WebDriver code or another framework.
Can I edit cookies while testing a site?
Yes. Extensions like Cookie-Editor let you view, change and delete cookies for the current site so you can reproduce login and consent states.
Is it legal to automate a website with Selenium?
Testing your own site is fine. Automating someone else's site may break its terms of service, so read the rules and permissions first.