For the complete documentation index, see llms.txt. This page is also available as Markdown.

Oxy® Proxy Extension for Chrome

Oxy® Proxy Extension for Chrome setup with Oxylabs Proxies – a quick integration guide. Free proxy manager that works with any provider.

Oxy® Proxy Extension is a proxy management extension for Chrome. It's free and works with any proxy provider of your choice.​

This quick guide shows how to integrate the following Oxylabs proxies:

Setup

1

Download and click the extension icon to open the application.

2

Click the +Add new proxy button.

3

A new tab will open up where you can set up your proxy profile.

Fill in the details of your chosen proxy type:

Residential & Mobile Proxies

Name

Project name

Protocol

HTTP or HTTPS

Domain

pr.oxylabs.io

Port

7777

Username

customer-USERNAME

Password

PASSWORD

You may also use additional parameters with residential and mobile proxies to set the geo-location (country, state, city, and etc.) and control sessions. Check out the Residential Proxies documentation to learn more. The table below provides an overview of available parameters and their example values.

Proxy parameter
Example

Country entry node

Host: us-pr.oxylabs.io

Port: 10000

Country

User: customer-username-cc-US

State

User: customer-username-st-US_texas

City

User: customer-username-city-paris

Continent

User: customer-username-cn-NA

ZIP/Postal code

User: customer-username-cc-US-postalcode-90210

ASN Targeting

User: customer-username-ASN-21928

Session

User: customer-username-sessid-qwerty123-sesstime-30

Session time

Host: us-pr.oxylabs.io

Port: 10001

Datacenter Proxies

Name

Project name

Protocol

HTTP or HTTPS

Domain

dc.oxylabs.io

Port

8000

Username

user-USERNAME

Password

PASSWORD

Pay-per-IP subscription

The port is the sequential number assigned to an IP address from the proxy list. Thus, port 8001 uses the first IP address from your list. You may also enable proxy IP rotation by setting the port to 8000.

Furthermore, you can specify the geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.

Pay-per-traffic subscription

Port 8001 picks a random IP address but stays consistent during a session. Alternatively, you can rotate proxy IPs with each request by using port 8000.

You can also specify geo-location, for example, the US, by setting the Proxy username to user-USERNAME-country-US.

Dedicated Datacenter Proxies (Enterprise)

Name

Project name

Protocol

HTTP

Domain

1.2.3.4 (example)

Port

60000

Username

USERNAME

Password

PASSWORD

For Enterprise Dedicated Datacenter Proxies, you’ll have to choose an IP address from the acquired list. Additionally, If you're using whitelisted IP addresses, you'll need to use port 65432. Visit our documentation for more details.

Dedicated Datacenter Proxies (Self-service)

Name

Project name

Protocol

HTTP or HTTPS

Domain

ddc.oxylabs.io

Port

8000

Username

user-USERNAME

Password

PASSWORD

For Self-Service Dedicated Datacenter Proxies, the port indicates the sequential number of an IP address from the acquired proxy list. If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

ISP Proxies

Name

Project name

Protocol

HTTP or HTTPS

Domain

isp.oxylabs.io

Port

8000

Username

user-USERNAME

Password

PASSWORD

With ISP Proxies, the port is assigned to a specific IP address and its location. Hence, port 8001 will always pick the first IP from your proxy list.

If you want to get a different IP with each request, change the Port to 8000 to enable proxy rotation.

Dedicated ISP Proxies

Name

Project name

Protocol

HTTP, HTTPS, or SOCKS5

Domain

disp.oxylabs.io

Port

8001

Username

user-USERNAME

Password

PASSWORD

The port number indicates which IP address from your acquired proxy list will be used. Use port 8000 for automatic proxy IP rotation.

4

Click Save changes.

5

Open the extension as shown in the first step and click Connect.

That's it. You're now using internet connection through Oxylabs proxies.

Whitelist

If you don't want to use proxies when accessing specific websites, you can add them to a whitelist. Open the extension, click Manage proxies, and then open the Global Bypass List.

For example, if you want to skip using proxies for https://ip.oxylabs.io/, you should enter the address like this: https://ip.oxylabs.io or ip.oxylabs.io. Once you visit this site, you should see your regular IP address instead of a proxy IP.

Common errors

Use the troubleshooting steps outlined below to fix common extension errors when using Oxylabs or other providers' proxies.

Proxies not connecting

Try disconnecting and re-connecting your proxies in the extension. If the issue persists, move on to the next step below.

Incorrect proxy credentials

Verify the proxy username and password you've entered are correct and match the credentials assigned by your proxy provider.

For Oxylabs Residential Proxies, ensure you're using the proxy user's username and password you've created in the Oxylabs dashboard. You can always edit these credentials in the dashboard by going to My ProductsDatacenter ProxiesUsers.

Invalid username without customer- or user- prefix

Oxylabs Residential Proxies require you to append the customer- string to your proxy user's username. For example, if your username is john_TFTdL, then you must enter your username as customer-john_TFTdL.

Oxylabs ISP, Dedicated ISP, Datacenter, and Self-Service Dedicated Datacenter Proxies require you to append the user- string to your proxy user's username. For example, if your username is john_TFTdL, then you must enter your username as user-john_TFTdL.

Invalid proxy domain or port

Make sure you're using a valid proxy domain and port number as assigned by your proxy provider.

Valid domains addressed for Oxylabs Proxies for each available proxy type can be found here:

Extension not working

If the extension is not working for some reason, try uninstalling and re-installing it through the Chrome web store or browser settings.

Disable third-party VPN

Turn off a third-party Virtual Private Network (VPN) if you're using it. It may conflict with the Oxy® Proxy Extension.

You can also check out our free Oxy® Proxy Manager app for Android. It allows you to easily add and manage proxies as well as switch between multiple IPs with a simple one-click connection.

Last updated

Was this helpful?