Guide
Proxy SwitchyOmega Setup Guide: Profiles, Auto Switch and Rules
Configure Proxy SwitchyOmega on Chrome or Firefox: create proxy profiles, set up authentication, build Auto Switch rules, use PAC scripts, and fix the errors people hit most.

Proxy SwitchyOmega manages multiple proxies in Chrome or Firefox and switches between them automatically based on rules you define. What separates it from simpler switchers is the Auto Switch profile: instead of picking a proxy by hand, you declare conditions — this domain through the German proxy, that one direct, everything else through a residential IP — and the extension routes each request accordingly.
That makes it the right tool when you are working across several proxies at once. It also makes it more configuration than most people need, so if you just want one site proxied, FoxyProxy will get you there faster.

A note before installing
SwitchyOmega's maintenance history is uneven. The original extension has gone through long quiet periods, and community forks exist under names like SwitchyOmega 3 and ZeroOmega. Which listings are live, and what they are called, changes over time.
So check the store listing before installing: look at the last update date, the reviewer count and the requested permissions. A proxy switcher sees every URL you visit, which makes it worth thirty seconds of diligence. The concepts below apply to the original and the forks alike, since they share the same profile model.
What you need
SwitchyOmega is a switcher, not a proxy service. Have ready:
- Protocol — HTTP, HTTPS, SOCKS4 or SOCKS5
- Server hostname or IP
- Port
- Username and password, if your provider uses credential auth rather than IP allowlisting
If you are not sure which protocol you were issued, HTTP, HTTPS and SOCKS5 compared covers it.
Installing
- Open the Chrome Web Store or Firefox Add-ons and search for Proxy SwitchyOmega.
- Verify the listing as described above, then install and confirm.
- On Chrome, click the Extensions (puzzle piece) icon and pin SwitchyOmega to the toolbar.
- Click the icon, then Options to open the settings page.
The options page has a left sidebar with Settings at the top, your Profiles below it, and an Apply changes button. That button is the thing to remember.
Creating a proxy profile
- Click New profile in the left sidebar.
- Name it something descriptive —
us-residential,de-datacenter. You will reference these names in rules later. - Choose Proxy Profile and click Create.
- In the proxy table, set:
- Protocol — from your provider
- Server — the endpoint hostname or IP
- Port — the port number
- For authentication, click the lock icon at the end of the server row and enter your username and password.
- Click Apply changes in the left sidebar.
Step six is not optional. SwitchyOmega stages your edits instead of committing them, and the Apply changes button displays a count of pending modifications. Skip it and your configuration silently does nothing — which is by far the most common reason people conclude the extension is broken.
Repeat for each proxy you want available.
Switching manually
Click the toolbar icon and select a profile. The built-in options are:
- Direct — no proxy, straight to the internet
- System proxy — defer to your operating system's settings
- Your named profiles — the proxies you created
- Auto Switch — rule-based routing, covered next
Manual switching is fine for spot checks. The reason to use SwitchyOmega is the next section.
Auto Switch: conditional routing
Auto Switch is a profile that routes to other profiles based on conditions.
- Click Auto Switch in the sidebar (it exists by default).
- You will see a condition list and a default profile at the bottom.
- Click Add condition.
- For each row, set three things:
- Condition Type — how to match
- Condition Details — the pattern
- Profile — where matching requests go
- Set the default profile for anything matching nothing.
Directis the usual choice. - Click Apply changes.
- Set the toolbar to Auto Switch.
Condition types worth knowing
| Type | Matches | Example |
|---|---|---|
| Host wildcard | Domain with wildcards | *.example.com |
| Host regex | Domain by regular expression | `^.*.example.(com |
| URL wildcard | Full URL with wildcards | *://example.com/api/* |
| URL regex | Full URL by regex | Complex path matching |
| Keyword | URL containing a string | youtube |
| IP literal | Requests to a literal IP | 192.168.0.0/16 |
Host wildcard covers most real needs. Reach for regex only when wildcards genuinely cannot express the rule.
A worked example
Say you want three behaviours at once: YouTube through a German proxy, a scraping target through a US residential proxy, everything else direct.
| Condition Type | Condition Details | Profile |
|---|---|---|
| Host wildcard | *.youtube.com | de-datacenter |
| Host wildcard | *.googlevideo.com | de-datacenter |
| Host wildcard | *.target-site.com | us-residential |
| (default) | — | Direct |
Two things to note. First, conditions are evaluated top to bottom, first match wins — so put specific rules above general ones. Second, the googlevideo.com row is there because YouTube streams video from a separate domain; a rule covering only youtube.com proxies the page but not the stream. Check your target's actual network requests rather than assuming one domain covers it.
PAC profiles
For logic that rules cannot express, create a PAC Profile and supply a proxy auto-config script — a JavaScript function returning which proxy to use per URL. You can paste a script or point to a URL that serves one.
Most people never need this. It earns its place when routing depends on something declarative rules cannot see, or when your organisation already distributes a PAC file you want to reuse.
Testing your setup
- Switch to the profile or to Auto Switch.
- Load a page that reports your public IP and confirm it matches the proxy.
- With Auto Switch, test both sides: a site that should be proxied and one that should not.
- Check the toolbar icon — SwitchyOmega indicates the active profile, which tells you what it thinks it is doing.
Fixing common errors
Changes do nothing. You did not click Apply changes. Check the sidebar for a pending-changes count. This is the first thing to rule out, every time.
407 Proxy Authentication Required. Credentials missing or wrong. Click the lock icon on the server row and re-enter them. If your provider uses IP allowlisting, confirm your current address is allowlisted.
Conditions never match. Usually a too-literal pattern. example.com as a Host wildcard does not match www.example.com — use *.example.com. Remember first-match-wins ordering too: a broad rule above a specific one will swallow it.
ERR_PROXY_CONNECTION_FAILED. Endpoint unreachable. Verify server and port, confirm the proxy is active with your provider, and check for a firewall blocking the port.
Some page elements load, others do not. Assets are coming from a domain your conditions do not cover. Open developer tools, look at the network tab, and add rules for the domains actually being requested.
Everything slowed down. Your default profile may be sending all traffic through a proxy. Set the Auto Switch default to Direct so only matched requests are proxied.
What causes proxy connection errors covers more failure modes.
SwitchyOmega compared with FoxyProxy
| SwitchyOmega | FoxyProxy | |
|---|---|---|
| Setup effort | Higher | Lower |
| Conditional routing | Advanced, many types | Basic patterns |
| PAC support | Full | Limited |
| Multiple proxies at once | Yes, by rule | Yes, by pattern |
| Staged changes | Yes, needs Apply | Saves directly |
| Best for | Complex multi-proxy workflows | Quick per-site routing |
If you are routing three or more proxies by rule, SwitchyOmega. If you want one site proxied in five minutes, FoxyProxy.
What it does not do
- No encryption. Routing is not privacy. HTTPS protects your traffic; the extension does not.
- Browser only. Native apps, mobile apps and CLI tools need separate configuration — see proxy settings by platform and cURL with a proxy.
- No IP rotation. Rotation happens at your provider's gateway. Point SwitchyOmega at a rotating endpoint and the provider handles it.
- No proxies included. You supply them.
FlameProxies residential proxies start at $0.50/GB, falling to $0.45/GB above 1TB, with HTTP(S) and SOCKS5 across 180-plus countries — so a single gateway endpoint works as one SwitchyOmega profile while the provider rotates the exit IPs behind it.
Frequently asked questions
- What is Proxy SwitchyOmega?
- Proxy SwitchyOmega is a browser extension for managing multiple proxies and switching between them automatically based on rules. Its distinguishing feature is the Auto Switch profile, which routes each request to a different proxy depending on conditions you define — host, URL pattern, regex or IP — rather than making you switch manually.
- How do I set up a proxy in SwitchyOmega?
- Open the extension options, click New profile, choose Proxy Profile and name it. Set the protocol, server hostname and port, then click the lock icon beside the server row to enter a username and password if your provider requires them. Finally click Apply changes in the left sidebar — configuration is not saved until you do.
- Why are my SwitchyOmega changes not saving?
- Because Apply changes has not been clicked. SwitchyOmega stages edits rather than committing them immediately, and the Apply changes button in the left sidebar shows a count of pending modifications. This is the single most common SwitchyOmega problem and it looks exactly like a broken extension.
- What is the Auto Switch profile?
- Auto Switch is a routing profile rather than a proxy. It holds an ordered list of conditions, each mapped to a proxy profile, plus a default for anything that matches nothing. Requests are tested against conditions top to bottom and sent through the first match, which lets you route different sites through different proxies simultaneously.
- Is SwitchyOmega still maintained?
- The original extension has seen long gaps in maintenance, and community forks have appeared under names such as SwitchyOmega 3 and ZeroOmega. Availability and listing names shift over time, so check the Chrome Web Store or Firefox Add-ons listing, its update date and its reviews before installing. The configuration concepts in this guide apply across the variants.
- SwitchyOmega or FoxyProxy?
- SwitchyOmega if you need conditional routing across several proxies at once, regex rules or PAC scripts. FoxyProxy if you want a proxy working with minimum configuration. SwitchyOmega is the more capable tool and the more fiddly one; for simple per-site routing the extra power is unnecessary.