# Oxy® Proxy Extension for Chrome

[**Oxy**® **Proxy Extension**](https://oxylabs.io/products/chrome-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 Oxylabs [**Dedicated ISP Proxies**](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service) you've purchased through self-service.

{% stepper %}
{% step %}

### Dowload the extension

[**Download**](https://chrome.google.com/webstore/detail/oxylabs-proxy-extension/infajoaodhhdogakhloedbppcbeajhoo) and click the extension icon to open the application.

<figure><img src="https://63892162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FLAEnI9jUmitOY6DTq31P%2Foxy-extension-1.png?alt=media&#x26;token=d52b929e-5fce-468d-938b-ea47716be814" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add new proxy

Click the **+Add new proxy** button.

<figure><img src="https://63892162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FbkOQueNFR677hcmlsPro%2Foxy-extension-2.png?alt=media&#x26;token=f92e1450-834c-4407-a6bb-4afa0da43a14" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Set up Dedicated ISP Proxies

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

Fill in the details as follows:

<table data-header-hidden data-full-width="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Name</strong></td><td><code>Project name</code></td></tr><tr><td><strong>Protocol</strong></td><td><code>HTTP</code>, <code>HTTPS</code>, or <code>SOCKS5</code></td></tr><tr><td><strong>Domain</strong></td><td><code>disp.oxylabs.io</code> </td></tr><tr><td><strong>Port</strong></td><td><code>8001</code></td></tr><tr><td><strong>Username</strong></td><td><code>user-USERNAME</code></td></tr><tr><td><strong>Password</strong></td><td><code>PASSWORD</code></td></tr></tbody></table>

{% hint style="success" %}
The port number indicates which IP address from your acquired [proxy list](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service/proxy-list) will be used. Use port `8000` for automatic [proxy IP rotation](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service/proxy-rotation).
{% endhint %}

{% hint style="warning" %}
Make sure to add the `user-` part to your username.
{% endhint %}
{% endstep %}

{% step %}

### Save configuration

Click **Save changes**.

<figure><img src="https://63892162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FDhnN49K3Vxw2d5Mx6Dom%2Foxy-1.png?alt=media&#x26;token=41e535ac-0357-4ae3-8fc5-9ee4660712bb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Connect

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

<figure><img src="https://63892162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FPeaiaSDkSSEra4tuFzC4%2Foxy-2.png?alt=media&#x26;token=2e3518f5-42ac-438d-b1d8-75e3a9902eaa" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

That's it. You're now using Dedicated ISP Proxies.

### Geo-location settings

When using static ports (e.g., `8001`, `8002`, etc.), you directly connect to an IP address located in a specifc country. Check your [proxy list](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service/proxy-list) to see the available locations.

When using [proxy rotation](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service/proxy-rotation) (port `8000`), to rotate IPs from a specific country, use a modified username format. For example, to connect to US-based proxies, enter your username as `user-USERNAME-country-US`.

### Static sessions

You can also use the same proxy IP address for multiple requests. Port `8000` always rotates through your proxy list, while connecting through port `8001` uses the IP assigned to this port. To switch IPs, change the port to `8002`, `8003`, etc. You can find the assigned port numbers in your [proxy list](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service/proxy-list).

### Global bypass list

If you don't want to use proxies when accessing specific websites, you can add them to the bypass list. Open the extension, click **Manage proxies**, and then open the **Global Bypass List**.&#x20;

<figure><img src="https://63892162-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzrXw45naRpCZ0Ku9AjY1%2Fuploads%2FcMaIWJaete3DEUfErIuw%2Foxy-extension-7.png?alt=media&#x26;token=21534bf2-b742-4232-859b-eaf4c335441f" alt=""><figcaption></figcaption></figure>

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.

{% hint style="warning" %}
After saving the changes, disconnect and reconnect the proxy to enable the bypass list.
{% endhint %}

### Common errors

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

<details>

<summary>Proxies not connecting</summary>

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

</details>

<details>

<summary>Incorrect proxy credentials</summary>

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

For Oxylabs Dedicated ISP Proxies, ensure you're using the **proxy user's** username and password you've created in the Oxylabs [dashboard](https://dashboard.oxylabs.io/). You can always **edit these credentials** in the dashboard.

</details>

<details>

<summary>Invalid username without appending <code>user-</code></summary>

Oxylabs Dedicated ISP Proxies, acquired via self-service, **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`.

</details>

<details>

<summary>Invalid proxy domain or port</summary>

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

A valid domain address for Oxylabs Dedicated ISP Proxies (purchased via self-service) is `disp.oxylabs.io` and port `8000`. See the full list of valid ports in the [dashboard](https://dashboard.oxylabs.io/en/). You can check the [documentation of ISP Proxies](https://developers.oxylabs.io/proxies/dedicated-isp-proxies/self-service/proxy-list) to learn more.

</details>

<details>

<summary>Proxy port out of range</summary>

Verify you've entered a **proxy port that isn't out of range**. For Oxylabs Dedicated ISP Proxies, visit the [dashboard](https://dashboard.oxylabs.io/en/) to find your proxy list with assigned port numbers.

</details>

<details>

<summary>Extension not working</summary>

If the extension is not working for some reason, try **uninstalling** and **re-installing** it through the [Chrome web store](https://chromewebstore.google.com/detail/oxylabs-proxy-extension/infajoaodhhdogakhloedbppcbeajhoo) or browser settings.

</details>

<details>

<summary>Disable third-party VPN</summary>

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

</details>

This guide is also available for [Datacenter Proxies](https://developers.oxylabs.io/proxies/integration-guides/shared-datacenter-proxies-guides/oxy-proxy-extension-for-chrome), [Residential Proxies](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations/oxy-proxy-extension-for-chrome), [Mobile Proxies](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations-1/oxy-proxy-extension-for-chrome-1), [ISP Proxies](https://developers.oxylabs.io/proxies/integration-guides/isp-proxies-integrations/oxy-proxy-extension-for-chrome), [Enterprise](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations-1-1/enterprise/oxy-proxy-manager) and [Self-Service Dedicated Datacenter Proxies](https://developers.oxylabs.io/proxies/integration-guides/3rd-party-integrations-1-1/self-service/oxy-proxy-extension-for-chrome).

You can also check out our free [**Oxy**® **Proxy Manager app**](https://oxylabs.io/products/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.
