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

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

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.