Setting Proxy in Selenium Made Easy

Set & Authenticate Proxy in Selenium. Test Local Website on Real Devices for a user-like experience before launching

Get Started free
Home Guide How to set Proxy in Selenium?

How to set Proxy in Selenium?

By Neha Vaidya, Community Contributor -

What is a proxy?

A proxy is an intermediary between client requests and server responses. Proxies are primarily used to ensure privacy and encapsulation between numerous interactive systems.

A proxy can also provide an added layer of security by operating as a firewall between client and web servers. This is especially useful when clients’ websites have to be labeled as allowed or blocked based on the website content. Websites often block IPs that make too many requests, and proxies are a way to get around this.

Testing with Proxy Servers

Proxy servers are most helpful in executing localization tests. Let’s say a tester wants to open an E-commerce website and check that the proper language settings and currency appear for users from a specific country.

  • An easy way to verify this is to access the website as a user would from a target location.
  • Like most tests, it would be easier to automate this activity, especially when a website has to be checked from multiple locations.

Selenium is the most widely used tool for running browser automation tests. Essentially, developers can use Selenium to monitor browser and website behavior without opening and executing an entire browser instance. This article will detail how to set up a proxy server and use it to access the website via Selenium.

BrowserStack Automate Banner 8

Setting up a Proxy Server

Many free proxy servers are unauthenticated, meaning a username and password are unnecessary.

An unauthenticated proxy server in Selenium can be set up with the following steps:

  • Import Selenium WebDriver from the package
  • Define the proxy server (IP:PORT)
  • Set ChromeOptions()
  • Add the proxy server argument to the options
  • Add the options to the Chrome() instance
from selenium import webdriver
PROXY = "11.456.448.110:8080"
chrome_options = WebDriver.ChromeOptions()
chrome_options.add_argument('--proxy-server=%s' % PROXY)
chrome = webdriver.Chrome(chrome_options=chrome_options)

Use this Chrome WebDriver instance to execute tests that incorporate the proxy server. For example, the following code snippet tests to ensure that a search field shows the user’s current city as the default location.

def testUserLocationZurich(self):
search ='user-city')
self.assertIn('Zurich', search.text)

To test a website from multiple locations by making this code reusable across separate tests, define a method that takes the proxy IP address as an argument.

selenium.webdriver.common.proxy  – Proxy contains information about the proxy type and necessary proxy settings.

Testers can run tests using an unauthenticated server. However, if they wish to use an authenticated server, they can follow the procedure below.

Authenticated Proxy

Authenticated proxy servers can be tedious to use in automated tests as there’s no built-in way to pass along proxy server credentials in Selenium. As of now, there are two options to handle authenticated proxies. The right choice depends on the testers’ requirements. It depends on factors like the version of Selenium and the headless browser used in tests.

Let’s learn how to use it.

  • The best way to integrate authenticated proxies with Selenium is by using PhantomJS as a headless browser instead of the Chrome WebDriver.
  • However, adding a browser extension to authenticate Selenium is possible.
  • While this approach is more complex, it can be used with the latest version of Selenium, which may be a requirement for some development teams.

Talk to an Expert

The first step is creating a Chrome extension by including two files in an archive named


var config = {
mode: "fixed_servers",
rules: {
singleProxy: {
scheme: "http",
port: parseInt(PROXY_PORT)
bypassList: [""]
chrome.proxy.settings.set({value: config, scope: "regular"}, function() {});
function callbackFn(details) {
return {
authCredentials: {
username: "PROXY_USERNAME",
password: "PROXY_PASSWORD"

{urls: ["<all_urls>"]},


"version": "1.0.0",
"manifest_version": 3,
"name": "Chrome Proxy",
"permissions": [
"background": {
"scripts": ["background.js"]

The Chrome extension can be added to Selenium using the add_extension method:

from selenium import webdriver
from import Options
chrome_options = Options()
driver = webdriver.Chrome(executable_path='chromedriver.exe', chrome_options=chrome_options)

This example uses a single proxy server in the extension. To add more proxy servers, the tester must make further modifications to the chrome.proxy API. If the tester uses a CI/CD server, they would have to be sure that the build machine has Chrome installed and the relevant browser extension added.

Run Selenium Tests on Real Device Cloud

Try running the code detailed above to set the proxy for Chrome using Selenium WebDriver. Remember that Selenium tests must be run on a real device cloud to get accurate results. BrowserStack’s cloud Selenium grid of 3000+ real browsers and devices allows testers to automate visual UI tests in real user conditions. Sign up, select a device-browser-OS combination, and run free tests.

Automation Testing Selenium Webdriver

Featured Articles

How to set Proxy in Firefox using Selenium WebDriver?

Desired Capabilities in Selenium Webdriver

Automation Tests on Real Devices & Browsers

Seamlessly Run Automation Tests on 3500+ real Devices & Browsers