Installation & Configuration


Installing the Plugin

Installing “Proxy & VPN Blocker” can be done either by searching for “Proxy & VPN Blocker” via the “Plugins > Add New” screen in your WordPress dashboard, or by using the following steps:

  1. Download the plugin via
  2. Upload the ZIP file through the ‘Plugins > Add New > Upload’ screen in your WordPress dashboard
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Follow the configuration guide below, you aren't quite finished yet!


Configuration of Proxy & VPN Blocker is simple with the following information. API key

After installing the Plugin to your WordPress please go to PVB > Proxy & VPN Blocker in your WordPress Dashboard and you will see that there are multiple settings that you can configure, one of which is the API Key field.

It is not necessary to have an API key to use this Plugin's basic features but note that it would be limited to 100 daily queries with

A free API Key gives you 1,000 daily queries and  is simple to get just by entering your email address to sign up with

There are also paid plans available!

If you have an API Key, enter it in the API Key field of Proxy & VPN Blocker.


If you are using Cloudflare please turn this setting to 'on' so your visitors IP Addresses are able to be forwarded to for checking. If you are not using Cloudflare or are not sure, leave this setting 'off'.

Day Restrictor

By default an IP is checked for proxy/vpn activity within the last 7 days but you can configure this to be as strict as you like between 1 and 60 days.

Detect VPN's?

By default only Proxies are checked for, if you would like to also block VPN's turn this setting to 'on'.

Use TLS?

Transport Layer Encryption is recommended to be 'on' however this has the potential to slightly slow down query time.

Custom Tag

If you enter a custom tag in this field this will show next to IP's in your Positive Detection Log rather than the URL of the querying site/page

Blocked Countries

This feature is ideal if you would like to block ALL visitors from specific countries.

Custom Blocked Page

By default the Plugin will show a default 'blocked' page to visitors who are blocked, however you can specify a page to use within your sites field for further customisability.

Note: Selecting a page here WILL turn off 'Block On All Pages' option. You also may not select a page here that already exists in your "Restrict on Specific Pages" List.

Access Denied Message

This is the message that is shown on the default "blocked" page shown to visitors who are blocked. You can change this to say anything you like (i.e. another language than English).

Restrict on Specific Pages

Here you can define a list of pages on your site that you would also like to block Proxies and (optionally) VPN's on. This is useful if you use WordPress for a web shop and would like to use this plugin on shopping cart/checkout pages.

Note: Selecting a page here WILL turn off 'Block On All Pages' option. This also may not work if you are using a page caching plugin

Block on All Pages?

This feature is not recommended to be used however it was added on request. This WILL result in much higher query usage to the proxycheck API.

This will block people using Proxies and (optionally) VPN's on all pages of your site!

Note: This will not work if you are using a page caching plugin.

Anti Click-Bombing?

This plugin has a rudimentary anti click-bombing feature that can hide sections of a page (ads for example) from proxies/vpn's if they are wrapped in <div class="pvb-protect-div"> ... </div>. Due to the javascript nature of this feature it is not difficult to circumvent but was added on user request.

Note: This will also not work if you use a plugin that caches pages!