Blackhole for Bad Bots icon
Security

Blackhole for Bad Bots

Blackhole is a WordPress security plugin that detects and traps bad bots in a virtual black hole, where they are denied access to your entire site.

  • By Jeff Starr
  • v3.9 New
  • Updated

Overview

Blackhole for Bad Bots describes itself as: “Blackhole is a WordPress security plugin that detects and traps bad bots in a virtual black hole, where they are denied access to your entire site.”

It is active on 30,000+ WordPress sites and rated 4.7 out of 5 by 148 users on WordPress.org. Developers can extend it through 6 actions and 38 filters, listed below.

We haven't published a hands-on review of Blackhole for Bad Bots yet. Want one, or need help with it? Send us a request.

How to install Blackhole for Bad Bots

  1. Open the plugin installer. In your WordPress dashboard go to Plugins → Add New Plugin.
  2. Search for it. Type “Blackhole for Bad Bots” and pick the one by Jeff Starr.
  3. Install and activate. Click Install Now, then Activate.
Install with a zip file or WP-CLI

Download the zip from the WordPress.org plugin page, then go to Plugins → Add New Plugin → Upload Plugin, choose the file and click Install Now. Or from the command line:

wp plugin install blackhole-bad-bots --activate

Requirements: WordPress 4.7+ · PHP 5.6.20+ · tested up to WordPress 7.2

Hooks & customisation

Blackhole for Bad Bots 3.9 fires 6 actions and 38 filters. Use them from your child theme or a snippets plugin to change how it behaves without editing its files.

blackhole-bad-bots — top hooks
// Filter in blackhole.php
apply_filters( 'blackhole_admin_footer_text', in_array($screen_id, $ids) );

// Filter in inc/blackhole-helpers.php
apply_filters( 'blackhole_alert_headers', $headers, $vars );

// Filter in inc/blackhole-helpers.php
apply_filters( 'blackhole_alert_message', $message, $vars );

// Filter in inc/blackhole-helpers.php
apply_filters( 'blackhole_alert_name', get_option('blogname') );

// Filter in inc/blackhole-helpers.php
apply_filters( 'blackhole_alert_subject', … );

// Filter in blackhole.php
apply_filters( 'blackhole_badbots', $blackhole_badbots );

Browse all 44 hooks with examples →

Need Blackhole for Bad Bots customised?

Tell us what you want changed, added or fixed and we'll reply with an estimate.

WP EXPERTS is independent and not affiliated with Jeff Starr. Plugin names and logos belong to their owners. Version, rating and install figures from WordPress.org, checked Nov 17, 2026.

Alternatives in Security

See all →

The best anti-spam protection to block spam comments and spam in a contact form. The most trusted antispam solution for…

5+ million installs Reviewed 43 hooks

Firewall, Malware Scanner, Two Factor Auth, and Comprehensive Security Features, powered by our 24-hour team. Make security a priority with…

5+ million installs 98 hooks

Easily improve site security with WordPress Hardening, Two-Factor Authentication (2FA), Login Protection, Vulnerability Detection and SSL certificate.

3+ million installs 116 hooks

Simplified WordPress management. Manage site info, maintenance, security, & redirects.

3+ million installs 7 hooks