Blacklist and Block Customers and Orders

Block unwanted or spam users from your store with the Blacklist for WooCommerce plugin. Create rules and restrict based on conditions such as name, IP address, phone number, or more.

Installation

↑ Back to top

Download the .zip file from your WooCommerce account.
Go to: WordPress Admin > Plugins > Add New and upload the file you have downloaded.
Install Now and Activate Plugin.

More information at Install and Activate Plugins/Extensions.

Configuration

↑ Back to top

After activating the plugin, go to WooCommerce > Settings > Blacklist Manager and configure the following:

General Settings

↑ Back to top

Go to WooCommerce > Settings > Blacklist Manager > General Settings and configure the following:

Admin Email Notification: Enable or disable email alerts for blocked customer attempts.
Email Subject: Customize the subject line of your notification email.
Email Body: Write a custom email body. Use supported placeholders to automatically populate the email with relevant event details, including email, name, IP address, action, rule, order number, source, reason, and a full details table.

Quick Blacklist

↑ Back to top

Go to WooCommerce > Settings > Blacklist Manager > Quick Blacklist and configure the following:

Add your values separated by commas or one per line, and choose a default action. It uses OR logic, meaning if any single condition matches, the selected action is applied immediately.

Default Action: Choose what happens when a match is found. Select from prevent order, cancel order, or block registration. Use the choose action option to store values without triggering any action until you are ready.
Emails: Add email addresses to block.
First Names: Add first names that you want to block. Accepts multiple values per line or comma-separated.
Last Names: Add last names, or enter a full first and last name together for more precise matching.
Phone Numbers: Add phone numbers to block.
IP Addresses: Add IP addresses to block.
Billing Countries: Add billing countries to restrict.
Shipping Countries: Add shipping countries to restrict.
Customer Error Message: Set a custom message that blocked customers will see, such as “You can not place an order with this email.”

Advanced Blacklist

↑ Back to top

Go to WooCommerce > Settings > Blacklist Manager > Advanced Blacklist and configure the following:

Rule Name: Enter a name for the rule.
Status: Set the rule to enabled or disabled. Disabled rules are saved but not evaluated until activated.
Action: Select the action to apply when the rule is matched. Options include prevent order, cancel order, and block registration.
Priority: Enter a numeric value to control the order in which rules are evaluated. Lower numbers are processed first.
Customer Error Message: Enter a message to display to the customer when this rule is triggered.
First Name: Enter a billing first name to match against this rule.
Last Name: Enter a last name or a full first and last name combination.
Email: Enter an email address.
Phone: Enter a phone number.
IP Address: Enter an IP address for adding to the blacklist.
Order Total Min: Enter a minimum order value.
Order Total Max: Enter a maximum order value.
Billing Country: Select one or more billing countries to block.
Shipping Country: Select one or more shipping countries that you want to block.

Activity Logs

↑ Back to top

Go to WooCommerce > Settings > Blacklist Manager > Activity Logs and configure the following:

Total Blocked Actions: Total number of blocking events triggered across your store.
Active Rules: Number of blacklist rules currently active.
Blocked Emails: Total blocks triggered by email address matches.
Blocked IPs: Total requests stopped by IP address rules.
Blocked Names: Total blocks triggered by customer name matches.
Blocked Billing Countries: Total orders restricted by billing country.
Blocked Shipping Countries: Total orders blocked by shipping country.

Every blocked event is recorded in a detailed log showing the date and time, username, email address, action type, matched rule source, and IP address. Use the search bar to filter by name, email, IP, or rule.