← Back to Permissions

Proxy

proxy
High RiskCategory: Web Traffic ControlView Official Docs↗
⚠

Install Warning

"Read and change all your data on all websites."

Technical Context

Grants full control over Chrome's proxy settings, allowing the extension to route all browser traffic through specified proxy servers. This affects all network requests from all tabs.

What This Means For You

The extension can redirect all your internet traffic through a different server before it reaches websites. This is powerful for privacy but means the proxy server sees all your browsing.

Related APIs

This permission enables access to these Chrome APIs:

chrome.proxy

Common Use Cases

  • ✓VPN extensions
  • ✓Privacy tools
  • ✓Network debugging

⚠ Red Flags When Combined With

cookieswebRequest

How to Declare in manifest.json

Add the "proxy" permission to your extension manifest:

{
  "manifest_version": 3,
  "name": "My Extension",
  "permissions": [
    "proxy"
  ]
}

What Users Will See

When users install your extension, Chrome will display this warning:

⚠

This extension can:

"Read and change all your data on all websites."

Related Permissions

Web Request Blocking

webRequestBlocking

The extension can block, redirect, or modify any request your browser makes before it happens. This is how ad blockers work, but it also means the extension controls what data reaches websites.

high

Web Request Auth Provider

webRequestAuthProvider

The extension can automatically provide usernames and passwords when websites request them through browser popup dialogs. This is useful for corporate proxies or secured intranet sites.

high

VPN Provider

vpnProvider

The extension can route all your internet traffic through a VPN tunnel. This encrypts your browsing but means the VPN provider sees all your traffic.

high

Web Request

webRequest

The extension can see the network requests your browser makes, like which images or scripts a page loads. By itself, it can only watch traffic, not change it.

medium

Cookies

cookies

The extension can see the small "id cards" websites use to remember that you are logged in. This allows the tool to help you manage your privacy or stay signed into multiple accounts simultaneously.

high