Launch the IDE
Once installed, launch it be clicking its icon from the menu bar in your browser.
Don't see the icon for Selenium IDE in your menu-bar?
Make sure the IDE is enabled in your browser's extension settings.
You can get there quickly by typing the following into your address bar and hitting
The extension might be enabled but the icon is hidden. Try resizing the menu bar to give it more space.
In Chrome, you can do this by clicking to the right of the address bar, holding the click, and dragging it left or right.
In Firefox you need right-click, click
Customize, make adjustments to the menu bar, and click
Upon launching the IDE you will be presented with a welcome dialog.
This will give you quick access the following options:
- Create a new project and start recording
- Open an existing project
- Close the IDE
If this is your first time using the IDE (or you are starting a new project), then select the first option.
Recording your first test
After creating a new project you will be prompted to name it and then asked to provide a base URL. The base URL is the URL of the application you are testing. It's something you set once and it gets used across all of the tests in this project. You can change it later if need-be.
After completing these settings a new browser window will open, load the base URL, and start recording.
Interact with the page and each of your actions will be recorded in the IDE. To stop recording, switch to the IDE window and click the recording icon.
Organizing your tests
You can add a new test by clicking the
+ symbol at the top of left side-bar menu (to the right of the
Tests heading), naming it, and clicking
Once added you can either input commands manually, or click the record icon in the top-right of the IDE.
Tests can be grouped together into suites.
On project creation a
Default Suite gets created and your first test gets added to it automatically.
To create and manage suites go to the
Test suites panel. You can get there by clicking the drop-down at the top of the left side-bar menu (e.g., click on the word
Tests) and selecting
Add a suite
To add a suite, click the
+ symbol at the top of the left side-bar menu to the right of the
Test Suites heading, provide a name, and click
Add a test
To add a test to a suite hover over the suite name, do the following:
- Click on the icon that appears to the right of the
- Select the tests you want to add from the menu
Remove a test
To remove a test, hover your mouse over the test and click the
X that appears to the right of the name.
Remove or rename a suite
To remove a suite click the icon that appears to the right of its name, click
Delete, and click
Delete again when prompted.
To rename a suite hover over the suite name, click the icon that appears to the right of the name, click
Rename, update the name, and click
Save your work
To save everything you've just done in the IDE, click the save icon in the top-right corner of the IDE.
It will prompt you to for a location and name of where to save the project. The end result is a single file with an extension ending in
You can play tests back in the IDE by selecting the test or suite you'd like to play and clicking the play button in the menu bar above the test editor.
The test(s) will play back in the browser. If a window is still open from recording, it will be used for playback. Otherwise, a new window will be opened and used.
If you want to run your IDE tests on additional browsers, be sure to check out the command-line runner.