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


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 credentials set in the default credentials section of your Settings, leave the default credentials checkbox enabled. However, if you would like to use custom credentials for this specific server, add custom credentials by unchecking the checkbox to enable the fields.
  4. Click Add New Proxy to finalize your settings.
Add new proxy server manually to extension

JSON Import

You can also import a custom JSON file with your server information directly into the extension.

  1. Open extension and click Settings, go to JSON Import
  2. Choose the JSON file to import & click the Import button

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

Domain Filters

Specify domains you’d like to include or exclude from proxied traffic. Exclusion domains are 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 Domain Filters menu option.
  2. Toggle the feature on
  3. Select the Include domains or Exclude domains option
  4. List the domains 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 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.