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

Download add-on for Chrome Download add-on for Firefox Microsoft Add-on Store Badge


Getting started

After installing the Switcher, follow the steps in the pop-up to add your WonderProxy credentials and import your 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 servers 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 custom credentials (optional)
  6. Click Save
Proxy Servers tab with Add Custom Server modal

Credentials

Save your WonderProxy or global credentials in the Switcher to make connecting to proxy servers easier. The Switcher uses these credentials for all proxy servers, unless you set custom credentials for specific servers.

The Switcher asks for your credentials during setup. You can update your credentials in the Credentials tab at any time.

WonderProxy credentials

If you have a WonderProxy account, enter your username and a proxy token.

When you click Save, the Switcher will verify your credentials and notify you if there are any problems.

The Switcher will tell you when your proxy token will expire.

Credentials tab with WonderProxy credentials

Global credentials

If you don't have a WonderProxy account, you can set global credentials to use for all your proxy servers. This is optional, but convenient if you use the same username and password for multiple servers.

Credentials tab with global credentials

Custom credentials

The Switcher uses your WonderProxy or global credentials by default for all servers. If you need to, you can change the credentials for individual servers.

  1. In the Proxy Servers tab, click Add Server or find an existing server and click Edit
  2. Uncheck the Use my WonderProxy (or global) credentials box
  3. Enter your credentials
  4. Click Save
Add Custom Server modal with custom credentials

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 (domain.com, *.domain.com)
  5. Save your changes
Preview of domain filter

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.