# 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 [**ISP Proxies**](https://oxylabs.io/products/isp-proxies).

### Setup

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

<figure><img src="/files/5sSxpqw17DWXHA0y9SRy" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click the **+Add new proxy** button.

<figure><img src="/files/8P5YfXnOMHSUloTADBGt" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}

{% step %}
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> or <code>HTTPS</code></td></tr><tr><td><strong>Domain</strong></td><td><code>isp.oxylabs.io</code></td></tr><tr><td><strong>Port</strong></td><td><code>8000</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="warning" %}
Make sure to add the `user-` part to your username.
{% endhint %}
{% endstep %}

{% step %}
Click **Save changes**.

<figure><img src="/files/pdpBvrvHmwRX3ehfNgTX" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/PvgeFUzqqbsZ1OJAoGbL" alt="" width="375"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

That's it. You're now using proxies with automatically rotating IP addresses.

### Geo-location settings

When using 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`. Check your [proxy list](broken://pages/fxSylAli7USCq3HOF7Jh) to see the available locations.

### 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://dashboard.oxylabs.io/?route=/overview/isp-proxies/proxy-lists).

Let's add a new static proxy that uses port `8001`:

<figure><img src="/files/gpPOoRkiqZeeHpNp5CbE" alt=""><figcaption></figcaption></figure>

After saving the changes, open the extension window and connect to the newly created proxy.

<figure><img src="/files/hTvAfY6KP6zc4R0B8YJ1" alt="" width="375"><figcaption></figcaption></figure>

### 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="/files/K9iy9kkeX4qWAE5dk1QK" 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 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 by going to **My Products** → **Datacenter Proxies** → [**Users**](https://dashboard.oxylabs.io/?route=/overview/isp-proxies/users).

</details>

<details>

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

Oxylabs ISP 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`.

</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 ISP Proxies is `isp.oxylabs.io` and port `8000`. See the [full list of valid ports](https://dashboard.oxylabs.io/?route=/overview/isp-proxies/proxy-lists) in the dashboard. You can check the [documentation of ISP Proxies](broken://pages/fxSylAli7USCq3HOF7Jh) 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 ISP Proxies, visit the dashboard to find your [proxy list with assigned port numbers](https://dashboard.oxylabs.io/?route=/overview/isp-proxies/proxy-lists).

</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](/integrations/proxy-integrations/datacenter-proxies-guides/oxy-proxy-extension-for-chrome.md), [Residential Proxies](/integrations/proxy-integrations/residential-proxies-guides/oxy-proxy-extension-for-chrome.md), [Mobile Proxies](/integrations/proxy-integrations/mobile-proxies-guides/oxy-proxy-extension-for-chrome-1.md), [Enterprise](/integrations/proxy-integrations/dedicated-datacenter-proxies-guides/enterprise/oxy-proxy-manager.md) and [Self-Service Dedicated Datacenter Proxies](/integrations/proxy-integrations/dedicated-datacenter-proxies-guides/self-service/oxy-proxy-extension-for-chrome.md).

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.oxylabs.io/integrations/proxy-integrations/isp-proxies-guides/oxy-proxy-extension-for-chrome.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.