> For the complete documentation index, see [llms.txt](https://help.proxidize.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.proxidize.com/proxidize-proxies/proxidize-proxy-extension.md).

# Proxidize Proxy Extension

Add, test, organize and connect to proxies from your browser toolbar, with smart per-site routing, one-click rotation, and WebRTC leak protection.

The Proxidize Proxy Extension lets you add, test, organize and connect to proxies straight from your browser toolbar, without ever opening your operating system's network settings.

It works with proxies from any provider, stores everything locally in your browser with no account to create, and adds per-site routing, one-click IP rotation and WebRTC leak protection.

[![Proxidize Chrome extension Link](https://content.gitbook.com/content/iAQa47xivOtQQ7mQZOnQ/blobs/by03Z4ogskqn2PdwW2wg/image%20png%20May%2020%202026%2002%2057%2035%203734%20PM.png)](https://chromewebstore.google.com/detail/proxidize-proxy-extension/gccdbcipcjgfnjlegofdhflkifgkdmpb?hl=en)[![Proxidize chrome extension URL](https://content.gitbook.com/content/iAQa47xivOtQQ7mQZOnQ/blobs/BlEThHZ8rE6Ac2DMoQl8/image%20png%20May%2020%202026%2002%2057%2044%206076%20PM.png)](https://addons.mozilla.org/en-US/firefox/addon/proxidize-proxy-extension/)

### What it does

<table data-search="false"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><strong>Any provider, any type</strong></td><td>HTTP, HTTPS, SOCKS4 and SOCKS5 proxies, from Proxidize or anywhere else</td></tr><tr><td><strong>Fast import</strong></td><td>Bulk paste or CSV upload, in several common formats</td></tr><tr><td><strong>Organized lists</strong></td><td>Names, country detection with flags, search, and pagination at 50 per page</td></tr><tr><td><strong>Built in testing</strong></td><td>Confirms reachability and authentication, and reports the egress IP and detected country</td></tr><tr><td><strong>One click connect</strong></td><td>Connect, switch and disconnect from the popup, with credentials applied automatically</td></tr><tr><td><strong>Smart routing</strong></td><td>Send chosen sites through a different proxy, or direct, while everything else follows your main one</td></tr><tr><td><strong>Bypass list</strong></td><td>Sites that always skip the proxy</td></tr><tr><td><strong>IP rotation</strong></td><td>Request a fresh egress IP without disconnecting</td></tr><tr><td><strong>WebRTC limiter</strong></td><td>Stops pages seeing your real IP while a proxy is connected</td></tr><tr><td><strong>Reload on change</strong></td><td>Reloads tabs when you connect or switch so pages pick up the new IP</td></tr><tr><td><strong>Local storage</strong></td><td>Your proxies and credentials stay in your browser</td></tr></tbody></table>

***

#### Browser and proxy type support

| Authentication                                | Chrome        | Firefox   |
| --------------------------------------------- | ------------- | --------- |
| HTTP or HTTPS with username and password      | Supported     | Supported |
| SOCKS5 with username and password             | Not supported | Supported |
| IP whitelisting, with no username or password | Supported     | Supported |

{% hint style="warning" %}
Chrome cannot send a username and password to a SOCKS proxy. This is a Chrome limitation rather than something the extension can work around.

If you need SOCKS5 in Chrome, authenticate by IP whitelisting instead. If you need username and password authentication, use an HTTP or HTTPS endpoint, which works fully in Chrome.
{% endhint %}

***

### Add your proxies

The list starts empty. Click **Add proxies** to open the import dialog, which handles both bulk paste and CSV upload.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FpP4Iaff8KLeA4PuX2vBl%2F02-add-proxies.png?alt=media&amp;token=cd999552-969c-4ce3-98d4-6bb79334b8f0" alt=""><figcaption></figcaption></figure>

#### Paste them

One proxy per line. The extension understands several formats:

```
host:port
host:port:username:password
host:port:username:password:type:nickname:country
scheme://username:password@host:port
```

**Default type** can stay on **Auto (detect on test)**, or you can pin every pasted line to HTTP or SOCKS5.

**Default nickname** labels the whole batch at once, which is useful when you are importing per project or per client.

**Format help** in the dialog reminds you of the accepted formats at any time.

#### Upload a CSV

Click **Choose CSV file** and pick a file with your proxies in the same field order as the paste formats above.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FxONBeZPZSBnGHX9JeLfG%2F19-csv-import.png?alt=media&amp;token=97276d18-ae9b-4340-b762-45a5240541d1" alt=""><figcaption></figcaption></figure>

***

### Your proxy list

Each row shows the proxy's **Name**, its **Country** with a flag, the **Type**, the **Endpoint**, the **Auth** with a copy button, the **Egress IP**, and per row **Actions**.

**Egress IP** stays empty until you test the proxy, since that is when the extension discovers it.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FNzDT0XYkY8UPZR1D0u3w%2F03-proxy-list.png?alt=media&amp;token=2cc992fb-d3d9-41a9-8e71-7b58747e0b43" alt=""><figcaption></figcaption></figure>

Search by name, host, country or type using the box at the top. Long lists paginate at 50 per page.

Select several proxies with the checkboxes to **Test** or **Delete** them together.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FiKAZgiHWBTw5DEDY3ngH%2F04-search-filter.png?alt=media&amp;token=609e5a4f-927e-4bcb-9555-63c1bdb26565" alt=""><figcaption></figcaption></figure>

***

### Test before you connect

Testing confirms the proxy is reachable and that authentication succeeds, then reports the egress IP and the country you will actually appear to browse from.

Click the flask icon on a row to test one, or select several and use **Test** in the toolbar.

A test in progress shows an indicator on the row, and you can cancel it.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FxwgMoM1DVBauxAS0Ez2W%2F05-testing-in-progress.png?alt=media&amp;token=204b3b5d-2f46-4cdc-a5cc-1c54c9677e1f" alt="" width="563"><figcaption></figcaption></figure>

When it finishes, each proxy shows a health indicator, its detected country and flag, and its egress IP.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FoPznUpmigNC2JrJ172gM%2F06-test-results.png?alt=media&amp;token=04105c78-b1e9-4414-93f4-80dfea15580b" alt="" width="563"><figcaption></figcaption></figure>

***

### Connect, switch and disconnect

Click the chain icon on a row to connect through that proxy.

To switch, just connect a different one. There is no need to disconnect first.

To stop, click the icon again or use the connection toggle at the top, which reads **Disconnected** or **Connected**.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2F6iObnfby2Q4d16rBZ8UT%2F07-connected.png?alt=media&amp;token=a2565b23-b5b9-4c43-9bca-6445c112fc08" alt="" width="563"><figcaption></figcaption></figure>

Saved credentials are applied for you, so authenticated proxies do not produce repeated browser login prompts when you connect or switch.

***

### Edit a proxy

Open a row's **More actions** menu and choose **Edit** to change the host, port, username, password, type, country, name, or the toolbar badge text.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FCqoaErkIQT47LevEvW0h%2F08-edit-credentials.png?alt=media&amp;token=36421729-8cdc-4955-b089-adb6f0c78ad4" alt="" width="563"><figcaption></figcaption></figure>

Credentials are stored with each proxy, which is what keeps connecting and switching quiet.

***

### Rotate the IP

If your provider supports rotation, you can request a fresh egress IP without disconnecting or re-entering anything. Set it up once in the proxy's **Edit** dialog, under **Rotation**.

There are two modes.

**URL** calls a rotation link your provider gave you. On a Proxidize Per Proxy plan, that is the rotation URL from the proxy's row in your dashboard.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FtTD6VHGPi0nHSHRGax6o%2F09-rotation-url.png?alt=media&amp;token=660bf0a9-194f-4921-aafa-97ac22353fb6" alt="" width="563"><figcaption></figcaption></figure>

**Session** rotates by changing the session token inside your proxy credentials, which is how sticky session proxies get a new IP. On Proxidize, that is the Per GB and pooling session key.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2F1Uh16sgPVR4BlIkEywu4%2F10-rotation-session.png?alt=media&amp;token=7191da29-0df1-4f39-bd86-dfc3b0da47fa" alt="" width="563"><figcaption></figcaption></figure>

Once configured, **Rotate IP** appears in the row's **More actions** menu, and asks you to confirm.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FOTV3wLeI7w6W07K07a7L%2F11-rotation-menu.png?alt=media&amp;token=4a1e7a50-95e8-49d2-bd54-cec603264711" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FBp4nbKlrAxUeScf9PU94%2F12-rotate-confirm.png?alt=media&amp;token=a522bdbf-860d-4a0f-9b89-58de20b2b403" alt=""><figcaption></figcaption></figure>

The gateway stays the same and only the egress IP changes.

***

### Settings

Everyday actions live in the popup. The rest lives on a **Settings** page, which you open from the popup's gear icon then **All settings**.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2Fo0fXO4LjmWQ7FYbYTSqA%2F13-options-overview.png?alt=media&amp;token=d72b92a3-a2be-48c6-b14a-176d654e3a5b" alt=""><figcaption></figcaption></figure>

#### Smart routing

Smart routing sends chosen sites through specific proxies while everything else uses the proxy you are connected to.

Add a rule, list the sites it covers, and choose where they should go. A master switch turns all rules on or off at once, and the section reads **Paused** while it is off.

The **Everything else** row at the bottom decides what happens to unmatched sites, and you can change it. While you are not connected to any proxy, unmatched sites go direct.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FzzT2I7pw8qpaRAhDpqLf%2F14-smart-routing.png?alt=media&amp;token=9037f892-2cbc-4b23-9369-64def4bf9fcd" alt=""><figcaption></figcaption></figure>

Rules are checked top to bottom and the first match wins.

{% hint style="info" %}
Each request is routed by its own host, so a page's third party content can follow a different rule than the page itself.

If a site half loads through the wrong connection, that is usually why: its assets or trackers live on other hosts.
{% endhint %}

#### Bypass list

Sites here always connect directly, skipping the proxy.

Entries cover subdomains, and you can add an IP address, or `<local>` to cover local addresses.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FWsz91KeV4DJryHsfqwKM%2F15-bypass-list.png?alt=media&amp;token=62c0b43a-6acf-4bfb-93cb-2230841ccd54" alt=""><figcaption></figcaption></figure>

This is the right place for internal tools, banks, and anything that breaks when proxied.

#### Advanced

**WebRTC limiter** routes WebRTC through the proxy so pages cannot see your real IP while a proxy is connected. It may affect video and voice calls, and because it protects new connections, reload open tabs after turning it on.

**On proxy change** reloads open tabs when you connect or switch, so pages show the new IP instead of the old one. Choose **Off**, **Active tab**, or **All tabs**.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FGMJDGgdY3QjBbY1uv4E7%2F16-advanced.png?alt=media&amp;token=b5500f39-4eeb-4b1a-9b6e-a8064703a702" alt=""><figcaption></figcaption></figure>

#### Quick settings

You do not need the full Settings page for the essentials. The popup's gear icon opens **Quick settings** for smart routing, the WebRTC limiter, and reload on change.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2F8360pkGAxgvFqNQzh9iD%2F17-quick-settings.png?alt=media&amp;token=93547415-f62d-407f-a838-79f447733c1e" alt="" width="563"><figcaption></figcaption></figure>

***

### Knowing which proxy is active

The popup's badge shows **Connected** or **Disconnected**, and the active proxy's row is highlighted.

The toolbar icon carries a badge for the active proxy, and you can set custom badge text per proxy in its **Edit** dialog.

When the WebRTC limiter is on, the connection indicator becomes a shield.

<figure><img src="https://3163533074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiAQa47xivOtQQ7mQZOnQ%2Fuploads%2FQm5N6yP9jcx18umXNfrB%2F18-connected-shield.png?alt=media&amp;token=df2b067a-be61-44a1-8826-59ab45f32c3a" alt="" width="563"><figcaption></figcaption></figure>

***

### Your data stays local

Your proxies and credentials are stored in your browser. There is no account to create and nothing synced to an external service.

That also means your list does not follow you between browsers or machines, so export or re-import if you move.

***

### Troubleshooting

<table data-search="false"><thead><tr><th>Problem</th><th>What to check</th></tr></thead><tbody><tr><td>A proxy fails its test</td><td>Re-check host, port, username and password. Confirm the proxy is active with your provider, and that your IP is allowlisted if it authenticates by IP</td></tr><tr><td>SOCKS5 with a username and password will not connect in Chrome</td><td>Chrome cannot authenticate SOCKS proxies. Use IP whitelisting for SOCKS, or an HTTP or HTTPS endpoint for credentials</td></tr><tr><td>Sites still show my old IP after switching</td><td>Set <strong>On proxy change</strong> to <strong>Active tab</strong> or <strong>All tabs</strong>, or reload the page yourself</td></tr><tr><td>A WebRTC test page shows my real IP</td><td>Turn on the <strong>WebRTC limiter</strong>, then reload your open tabs</td></tr><tr><td>One site breaks while connected</td><td>Add it to the <strong>Bypass list</strong>, or give it a smart routing rule pointing at <strong>Direct (no proxy)</strong></td></tr><tr><td>A page loads partly through the wrong connection</td><td>Its third party hosts are matching a different rule. Add those hosts to the same rule or to the bypass list</td></tr><tr><td>Repeated login prompts when connecting</td><td>Save the username and password in the proxy's <strong>Edit</strong> dialog so credentials apply automatically</td></tr><tr><td>The egress IP is not what I expected</td><td>Test the proxy again to refresh it, or rotate it if your provider supports rotation</td></tr></tbody></table>

***

### Related articles

* [Setting Up Your Proxidize Proxies](/getting-started/setting-up-your-proxidize-proxies.md)
* [Mobile - Per Proxy](/proxidize-proxies/mobile-proxies/mobile-per-proxy.md)
* [Mobile - PerGB](/proxidize-proxies/mobile-proxies/mobile-pergb.md)
* [Residential - perGB](/proxidize-proxies/residential-pergb.md)

***

### Need help?

If you have any questions, concerns, or need further clarification, feel free to reach out to us via live chat or email us directly at <support@proxidize.com>.

***

### Enjoying the extension?

If it has been useful, a short review on the [Chrome Web Store](https://chromewebstore.google.com/detail/proxidize-proxy-extension/gccdbcipcjgfnjlegofdhflkifgkdmpb) or [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/proxidize-proxy-extension/) helps other people find it, and tells us what to build next.

Found a problem instead? Tell us through **Send feedback** in the extension's settings, or reach us on live chat, and we will fix it.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.proxidize.com/proxidize-proxies/proxidize-proxy-extension.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.