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.
How to install Blackhole for Bad Bots
- Open the plugin installer. In your WordPress dashboard go to Plugins → Add New Plugin.
- Search for it. Type “Blackhole for Bad Bots” and pick the one by Jeff Starr.
- 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 --activateRequirements: 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.
// 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 );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.