Skip to content
DocumentationSetupProxy

Add Ons

Use our WonderProxy Switcher browser extension to quickly switch between your account's proxy/vpn servers

WonderProxy Switcher

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

Installation

Chrome Store Badge Firefox Add-on Store Badge


Setup

After installing the Switcher, follow the steps in the pop-up to complete setup by adding your WonderProxy credentials and importing your servers.

Preview of WonderProxy switcher browser extension

Adding Proxies

Import

You can import all of your account's proxy servers into the WonderProxy Switcher with a click of a button.

  1. Go to your account's servers page
  2. Click on the Import to Extension link to trigger the import
Preview of WonderProxy switcher browser extension

Manual

  1. Open WonderProxy Switcher extension and click Settings
  2. To add individual proxies, click Add New
  3. Fill in the new proxy form fields:
    • Display name can be the server's name, e.g. Toronto
    • Host will be the hostname for your server as found in your account's servers page, e.g. toronto.wonderproxy.com
    • Port can be 10000, 11000, 12000 or adjusted to use different IPs. See port documentation
    • If you want to use your WonderProxy credentials, leave the WonderProxy credentials checkbox enabled. You can enter and verify your credentials on the Credentials page.
    • If you would like to use custom credentials for this specific server, uncheck the checkbox to add custom credentials.
  4. Click Add New Proxy to finalize your settings.
Add new proxy server manually to extension

Geolocation

The WonderProxy Switcher supports two types of localization testing:

  • GeoIP testing: Websites localized with geoIP determine your location based on your IP address. All WonderProxy servers are physically located where we say they are, so their IP addresses map to the right locations. When you use one of our proxies, your localized website will place you at the location of the proxy.

  • Browser location testing: Your browser can determine the physical location of your computer using GPS, WiFi positioning, cell network positioning, and other methods. When you connect to a WonderProxy server, the Switcher updates your browser location with the latitude and longitude of the proxy server. Your browser location will be the location of the proxy server, instead of your current location.

Browser location & geoIP testing

To use the Switcher for browser location testing:

  1. Enable location sharing in your browser settings:
    Share your location in Chrome
    Share your location in Firefox
  2. Connect to a WonderProxy server
  3. Visit the site you want to test
  4. Allow the site permission to access your location
Location permissions for Chrome
Location permissions for Chrome
Location permissions for Firefox
Location permissions for Firefox

While you're connected to one of our proxies, your browser will reflect the location of the proxy, instead of your actual location. Your IP address will also reflect the location of the proxy.

Note: browser location testing is only supported for WonderProxy servers that you imported from your account. If you manually added your own servers, the Switcher will not update your browser location.

GeoIP testing only

When you're connected to a WonderProxy server, your IP address will always reflect the location of the proxy server. If you don't want to share your browser location with a website you're testing, you can still use the Switcher for geoIP testing.

Disable all location sharing

To turn off all location sharing in your browser:

  1. Open your browser's location sharing settings
  2. Disable all location sharing
  3. Remove any sites that you've previously allowed
Deny location sharing for specific sites

Alternatively, you can simply deny location sharing requests for specific sites, when prompted by your browser.


Setting a Reminder

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

  1. Open WonderProxy Switcher 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 WonderProxy Switcher 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 WonderProxy Switcher 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

When you have a filter enabled, the Switcher will not update your browser location for any domains or IPs that are not using the proxy.


Warnings & Notices

Notice for Chrome 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 WonderProxy Switcher.

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