Custom Rules | ZeroBot Docs

What are Custom Rules?

Custom Rules are the heart of ZeroBot's protection system. Each rule defines how traffic is filtered for a specific antibot link — including blocking options, device and country restrictions, cloaking, captcha, and notification settings.

You must create at least one Custom Rule after uploading your ZeroBot script to activate protection.

Required: Without a Custom Rule, your ZeroBot script will not filter any traffic. Always create a rule for each antibot link you deploy.

Setup Guide

Creating a Custom Rule

1

Open Custom Rules

Go to ZeroBot Dashboard → Custom Rules from the sidebar menu.

2

Click "Add New Rule"

Click the Add New Rule button to open the rule creation form.

3

Configure Basic Settings

Set the Antibot Link (your deployed ZeroBot file) and the Redirect Link (where real visitors go).

4

Enable Protections

Toggle the protections you need: VPN Block, Datacenter Block, Fingerprint, Captcha, and more.

5

Save the Rule

Click Save to activate the rule. Your antibot link will immediately start filtering traffic.

Rule activated! All visitors to your antibot link will now be filtered according to your settings.

Reference

Full Settings Reference

Setting	Explanation
Basic Information
Antibot Link	The protected ZeroBot file (e.g. `ZeroBot_V8.php`) where the rule is applied.
Redirect Link	The destination URL where legitimate visitors are redirected after passing all filters.
Blocking Controls
Block VPN	When enabled, visitors using VPN or proxy services are blocked as invalid traffic.
Block Datacenter	Blocks traffic from hosting providers, cloud servers, and datacenters commonly used by bots.
Fingerprint Activate	Enables browser fingerprinting to detect advanced bots, repeated users, and automation tools.
Wildcard Subdomains	When enabled, this rule automatically applies to all subdomains of the configured domain. For example, a rule set for `example.com/page` will also match `abc.example.com/page`, `xyz.example.com/page`, and any other subdomain. This is useful for redirect campaigns that use random subdomains — one rule protects all of them. Each subdomain's traffic is tracked separately in the Antibot Traffic page.
Devices & Countries
Allowed Countries	Select which countries are allowed. Visitors from non-selected countries are blocked.
Allowed Devices	Restrict by device type: All Devices — No restriction • Mobile — Only smartphones & tablets • Desktop — Only desktop browsers
Analytics & Notifications
Views File Name	The file used to store visitor logs and analytics (default: `views.php`).
Telegram Token & Chat ID	Enables Telegram notifications for rule activity and red page detection.
Captcha Settings
Captcha Activation	Enables Cloudflare Turnstile captcha to verify real visitors before granting access.
Captcha Cloudflare Key	Your Cloudflare Turnstile Site Key used when captcha protection is enabled.
Captcha Domain Name	The domain name displayed on the captcha page (e.g. `example.com`). Helps brand your captcha experience.
Captcha Logo	Optional URL to a custom logo image displayed on the captcha page (e.g. `https://example.com/logo.png`).

Managing Rules

From the Custom Rules page, you can:

Edit — Click the edit button on any rule to modify its settings.
Delete — Remove a rule that is no longer needed.
Toggle Status — Enable or disable a rule without deleting it.

Changes to rules take effect immediately. No need to re-upload or restart anything on your server.

Best Practices

Enable Fingerprinting

Always enable fingerprinting for the strongest bot detection. It catches advanced bots that bypass IP checks.

Restrict Countries

Only allow countries relevant to your audience. This blocks a large portion of bot traffic automatically.

Thank You

Thank you for choosing ZeroBot! Custom Rules give you full control over how your traffic is handled. Configure them carefully for maximum protection.

Need help? Our support team is always ready to assist via Telegram or our support center.