TL;DR

What are they?

Patterns are a way to specify groups of URLs: a pattern matches a specific set of URLs. If a white pattern matches a URL the browser wants to load, the proxy for that white pattern is used to load the URL unless a black pattern also matches! Black patterns take precendence over white patterns and are always checked first. If both white and black patterns (in the same proxy) match a URL, that proxy is not used to load that URL.

Ordering

Every URL is compared with the patterns for each proxy. The white/black patterns for the top-most (first) proxy are checked first, then the next set of white/black patterns are checked, and on down the list of proxies until there is a match. If there is no match, Firefox's native proxy settings are used to load the URL. Older versions of FoxyProxy had a Default proxy that acted as a catch-all to matches all URLs. You may still have Default in FoxyProxy if you upgraded from a previous version.

You can re-order the proxies using the arrow buttons as you like, but the white/black patterns for the top-most (first) proxy are checked first.

If a black pattern matches, the proxy is not used for that URL even if a white pattern also matches. The black pattern takes priority. The URL may, however, load through another proxy you've defined if that proxy has a matching whitelist pattern and no matching blacklist pattern.

The order of white patterns and black patterns within a proxy do not matter.

Wildcards

Examples

Notes

If a wildcard pattern begins with . or *. then it matches the main domain and all subdomains in a URL.

To match only subdomains, use ** instead of * in the beginning. Example: **.foxyproxy.com will match help.foxyproxy.com but will not match foxyproxy.com.