Skip to content
DocumentationSetupProxy

Add Ons

Use our WonderSwitcher browser extension to quickly switch between proxy servers

WonderSwitcher

The WonderSwitcher browser extension is designed to allow you to start testing sooner, and complete your manual testing faster.

Installation


Getting started

After installing the Switcher, follow the steps in the pop-up to import your WonderProxy servers or add custom servers.

WonderSwitcher pop-up showing onboarding steps

Search or browse to find a proxy server, and click to connect. When you are connected to a proxy server, the Switcher icon will turn green.

Access your settings and more features by clicking the gear icon in the pop-up.

WonderSwitcher browser extension popup and settings

Proxy servers

Manage your proxy servers in the Proxy Servers tab in your settings.

Import WonderProxy servers

Import all servers from your WonderProxy account with the click of a button.

  1. Go to your account's Switcher page
  2. Click Import to Switcher

When you add or remove servers in your WonderProxy account, import them to the Switcher again to keep your list updated.

Account servers page with Import to Switcher button

Add custom servers

If you have your own proxy server you'd like to use, you can add a custom server.

  1. In the Proxy Servers tab, click Add Server
  2. Set a display name, e.g. Custom Server
  3. Set a hostname, e.g. example.com
  4. Set a port, e.g. 12000
  5. Set a username and password (optional)
  6. Click Save
Proxy Servers tab with Add Custom Server modal

Authentication

When you import from your WonderProxy account, you update the Switcher with your current server list, your username, and a new proxy token. The Switcher will use your username and proxy token for WonderProxy server authentication.

If you choose to add a custom server manually, you can enter the username and password required by that server when you add it.


Geolocation

The Switcher supports two types of localization testing:

Type Description
GeoIP Send your browser traffic through a proxy server, so it reflects the proxy server's IP address and location
Browser geolocation (optional) Override how your browser reports your location to match the coordinates of the proxy server

All WonderProxy servers are physically located where we say they are. When you connect to a WonderProxy server, your geoIP and browser geolocation will reflect your selected location.

Both of these features:

  • Work only while you are connected to a proxy
  • Respect any filters you have enabled

GeoIP testing

When you connect to a WonderProxy server, your browser traffic will travel through that proxy server and adopt its IP address. Any websites that are localized with geoIP will place you at the location of the proxy server.

This feature works automatically whenever you connect to a WonderProxy server.

Browser geolocation testing

Your browser can determine the physical location of your device using GPS, WiFi positioning, cell network positioning, and other methods. When you connect to a WonderProxy server, the Switcher can override your browser location to match the latitude and longitude of the proxy server.

Geolocation overriding is optional, but on by default. You can manage this feature in the Geolocation tab. This feature is not available for custom servers.

  1. Enable Override browser geolocation
  2. Enable location sharing in your browser settings:
    Share your location in Chrome
    Share your location in Firefox
    Share your location in Edge
  3. Connect to a WonderProxy server
  4. Visit the site you want to test
  5. Allow the site permission to access your location, when prompted
Geolocation settings tab with override toggle enabled

When geolocation overriding is enabled, a small globe icon will appear in the Switcher popup.

Geolocation icon in Switcher popup
Geolocation overriding enabled

Reminder

Display a flashing notice on the extension icon when a specified amount of time has passed.

  1. Open WonderSwitcher extension and click Settings, then the Reminder option in the side menu
  2. Ensure that the reminder setting is enabled and you have entered an amount in minutes
  3. Save your changes
Preview of setting up a reminder in the settings panel

Set a custom HTTP header that will be included when using the Switcher. It's occasionally useful to identify your testing traffic, either to bypass your CDN, or to have your testing traffic omitted from analytics.

  1. Open WonderSwitcher extension and click Settings, then Header from the side menu
  2. Ensure that the feature is toggled on, and you have added values to both required fields
  3. Make sure to save your changes
Preview of setting up a HTTP header in the settings panel

Filters

Specify domains or IP addresses you’d like to include or exclude from proxied traffic. Exclusion is useful when you wish to access internal network resources (like a bug tracker) while using the proxy. Inclusion is useful when you wish to only route some traffic through the proxy (like your website) while skipping the proxy for all other traffic.

  1. Open WonderSwitcher extension and click Settings, then click the Filters menu option.
  2. Toggle the feature on
  3. Select the Include traffic or Exclude traffic option
  4. List the domains or IPs you would like to filter, separated by commas (example.com, docs.example.org) All subdomains of listed domains are automatically included, so example.com covers mail.example.com, blog.example.com and dev.blog.example.com.
  5. Save your changes
Preview of domain filter in Google Chrome
  1. Open WonderSwitcher extension and click Settings, then click the Filters menu option.
  2. Toggle the feature on
  3. Select the Include traffic or Exclude traffic option
  4. List the domains or IPs you would like to filter, separated by commas (example.com, docs.example.org). You can use the * wildcard to match all subdomains of a domain, so *.example.com covers mail.example.com, blog.example.com and dev.blog.example.com.
  5. Save your changes
Preview of domain filter in Mozilla Firefox

Warnings & notices

Notice for Chrome & Edge users

This popup may appear at some point after installing this plugin. It's warning you (correctly) that configuring a proxy server means all the data in your browser will be sent through that proxy. In our case, that's what we want: to use a proxy server for geoIP testing. You will need to select "Keep Changes" to continue using the WonderSwitcher.

Chrome Warning: Your Internet Connection is Being Controlled, etc.