Switch Tabs in Selenium Python: Step-by-Step

This guide shows you how to switch between browser tabs when automating with Selenium WebDriver in Python. You’ll learn to grab the list of open window handles, move to a specific tab, and close or return to the original one—essential for handling pop-ups, multi-step flows, and external links.

What You’ll Need

Python 3.6+ installed on your system.
Selenium installed: pip install selenium
A WebDriver for your browser (e.g., ChromeDriver for Chrome, GeckoDriver for Firefox) available in your PATH or specified by path.
A basic understanding of Python and Selenium basics (finding elements, clicking).

Step-by-Step

Import Selenium and start a driver.
Begin by importing the necessary modules and launching your browser. Example: from selenium import webdriver then driver = webdriver.Chrome() (or Firefox, etc.).
Open the initial page.
Use driver.get('https://example.com') to load your starting URL. This creates the first tab.
Open a new tab (if not already open).
To open a new tab programmatically, execute JavaScript: driver.execute_script("window.open('https://example.org', '_blank');"). This opens a second tab but does not switch to it.
Get the list of window handles.
Call handles = driver.window_handles. This returns a list of unique strings, each representing a tab or window. The order is generally the order they were opened.
Switch to the desired tab.
Use driver.switch_to.window(handles[1]) to switch to the second tab (index 1). Replace the index with the correct one for your scenario. After switching, Selenium interacts with that tab only.
Perform actions on the new tab.
Now you can find elements, click, fill forms, etc., on the active tab. For example: print(driver.title) to confirm you’re on the right page.
Switch back to the original tab.
Use driver.switch_to.window(handles[0]) to return to the first tab. This is useful if you need to continue working there.
Close a tab (optional).
To close the current tab, call driver.close(). Note that this closes the tab but leaves the driver running. After closing, switch to another remaining tab to continue.
Quit the driver when done.
Finally, call driver.quit() to close all tabs and end the session. This is essential to free resources.

Common Mistakes

Using driver.switch_to_window (old syntax). In modern Selenium (4.x), the method is switch_to.window. The old one still works but is deprecated.
Assuming handle order is predictable. The order of window_handles is not guaranteed to be the order of opening in all browsers. Always identify tabs by their content or URL rather than relying solely on index.
Not updating the handles list after opening/closing tabs. The list is static; you must re-fetch it after any tab opens or closes.
Forgetting to switch back before interacting with the original tab. If you don’t switch, Selenium will keep acting on the last active tab.
Calling driver.close() and then trying to interact without switching. After closing, the driver may not know which tab to use; always switch to a valid handle.

Tips

Use explicit waits after switching. The new tab may take time to load. Use WebDriverWait to wait for a specific element or condition before interacting.
Identify tabs by their URL or title. Loop through handles, switch to each, check driver.current_url, and break when you find the one you need.
Store handles in a variable. Keep a reference to the original handle so you can always return to it.
Use context managers or try/finally for cleanup. Ensure driver.quit() is called even if an exception occurs.
For pop-ups that are new windows (not tabs), the same method works. Selenium treats windows and tabs the same way using window handles.

Troubleshooting

It says “NoSuchWindowException” or “Unable to locate window”. This usually means the handle you’re using is stale. Re-fetch driver.window_handles and try again.
The new tab doesn’t open. Ensure your JavaScript syntax is correct. Some browsers block pop-ups; you may need to adjust browser settings or use a different method like sending Ctrl+T (keyboard shortcut) via ActionChains.
Switching doesn’t change the active tab. Double-check that you’re using the correct handle. Print all handles and their titles to debug.
The driver closes unexpectedly. If you call driver.close() on the only remaining tab, the session ends. Always ensure you have at least one tab open before closing.
StaleElementReferenceException after switching. This happens when you try to interact with an element from a previous tab. Re-locate elements after switching.

Frequently Asked Questions

How do I switch to a tab by its title?

Loop through all handles, switch to each, check driver.title, and break when it matches your target. Example: for handle in driver.window_handles: driver.switch_to.window(handle); if driver.title == 'Desired': break.

Can I switch to a tab by its URL?

Yes, similarly loop through handles and check driver.current_url instead of title.

What’s the difference between `driver.close()` and `driver.quit()`?

close() closes the current tab or window; quit() ends the entire browser session and closes all tabs. Use quit() when you’re done.

Why does my new tab open but Selenium stays on the old one?

Opening a new tab does not automatically switch focus. You must explicitly call driver.switch_to.window(new_handle).

Is the handle order always the same as the tab order?

Not necessarily. It’s safer to identify tabs by content rather than index, as the order can vary by browser and timing.

Can I switch to a tab that was opened by a JavaScript popup?

Yes, as long as it’s a separate window or tab, it will have its own handle. Use the same switching method.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →