Install

Works with Drupal: ^10 || ^11

Using Composer to manage Drupal site dependencies

Alternative installation files

Download tar.gz 114.79 KB
MD5: eaa60898931b58b9cfb955dfc591968c
SHA-1: b65ae56491c58f783dd2373c9a655ca87fafeeb1
SHA-256: 5337036933fa48de85aa759aed1c00a359c59f6db2f31ab7e25d352e0c2ce953
Download zip 137.66 KB
MD5: 53eb00a61e7297c4fb9f9585e036786e
SHA-1: 2f453dea1483323ef52dd198bf23882433b7bc24
SHA-256: 97014b51e8cfb7cdb65109e1cd49ed6e7ee052f85017408eb1419f0fbc4b94c0

Release notes

BotShield helps Drupal sites detect bot traffic, apply per-bot/IP limits or blocks, enrich events with geo data, and use reports to safely tune crawler access.

BotShield is a Drupal module that gives administrators visibility and control over automated traffic. It classifies bots, enforces configurable policies, and provides reports for safe tuning.

Features

  • Classifies known and custom bots using User-Agent rules.
  • Supports per-bot actions: allow, rate_limit, and block.
  • Supports IP/CIDR rules plus override-file support for always-allow IPs.
  • Adds path-group rules and per-group thresholds.
  • Includes flood safety-net controls, including stricter unknown-bot handling.
  • Enriches events with geo data from headers, GeoLite2 MMDB, and optional free API fallback.
  • Provides report pages: dashboard, status, log, map, and alerts.
  • Supports customizable 429 response messaging.
  • Includes retention cleanup via cron.

Use Cases

  • High-traffic sites needing crawler control without blocking all bots.
  • Editorial/operations teams needing visibility into bot behavior and origin.
  • Sites that want Drupal-native bot controls and reporting.

Post-Installation

Created by: jnguyen23
Created on: 5 Mar 2026 at 19:46 UTC
Last updated: 5 Mar 2026 at 19:46 UTC
New features

Other releases