Home / Documentation / Rate Limiting
TMB Bot Guard

Rate Limiting

Configure traffic thresholds, pattern analysis, enforcement, Activity Log context, and exclusions.

How this differs from strikes

The core strike system responds to confirmed bot evidence. Rate Limiting responds to request volume and traffic shape. A rate-limit event does not automatically add a Bot Guard strike, and clearing strikes does not clear active rate limits.

Quick statistics

The module summarizes requests during the current hour, active rate limits, and pattern detections from the last 24 hours. Reset Statistics clears module statistics; it does not change the main strike table.

Request Frequency Limits

SettingWhat it measures
Requests per MinuteTotal requests one IP may make in one minute.
Requests per HourTotal requests one IP may make in one hour.
Background Admin Requests per MinuteWordPress background requests used by forms, dashboards, and interactive features.
Integration Requests per MinuteRequests through WordPress integration and application endpoints.
Rapid Request ThresholdHow many requests arriving very close together count as a burst. Higher values are more tolerant.

Suspicious Pattern Thresholds

SettingWhat it means
Minimum Page VarietyExpected diversity in requested pages. Lower values permit more repetition; higher values expect more varied browsing.
Maximum Integration Request PercentageFlags traffic when too much of its activity targets integration endpoints rather than ordinary pages.
Maximum Background Request PercentageFlags traffic dominated by WordPress background requests.
Act on Suspicious Request PatternsApplies the selected enforcement action. Leave off initially to observe patterns without restricting visitors.

Enforcement

ActionEffect
Log OnlyRecords the event without affecting the visitor. Recommended for initial tuning.
Throttle RequestsSlows repeated activity while still allowing some traffic.
Add DelaysInserts a short wait into excessive traffic.
Block CompletelyDenies further access under the module’s enforcement path.

Exclude Logged-in Users prevents administrator and member sessions from being rate limited. Email Alerts for Patterns uses configured Email Notification recipients. Show Rate-Limit Events in Activity Logs adds context without changing the main strike count.

Module IP Whitelist

Enter one trusted address per line. This list bypasses Rate Limiting only; it is distinct from the main Bot Guard IP whitelist.

Safe rollout

  1. Enable with Log Only.
  2. Exclude logged-in users and known integration servers.
  3. Observe legitimate peaks for several days.
  4. Set thresholds above normal maximums.
  5. Use Test Configuration.
  6. Move to Throttle or Add Delays, then consider Block Completely only after review.
Forms and integrations can be bursty. Test checkout, login, search, page builders, webhooks, APIs, and background jobs before enforcing low limits.