Visser Labs – WooCommerce Plugins

  1. Home
  2. Knowledge Base
  3. Getting Started
  4. Getting started with Checkout Guard
  1. Home
  2. Knowledge Base
  3. Checkout Guard
  4. Getting started with Checkout Guard

Getting started with Checkout Guard

Fake orders, spammy sign-ups, and repeat problem customers cost you time on every order you have to cancel and refund by hand. Checkout Guard stops those orders before they’re placed. It blocks checkout for any customer whose name, email, or IP address matches a rule you set, so you catch the problem before it becomes a fulfillment headache.

This article covers installing Checkout Guard, activating your license, and setting up your first blocked entry. For a broader look at what the plugin does day to day, keep this article bookmarked as your starting point.

Prerequisites

RequirementDetails
WordPressVersion 5.2 or later
WooCommerceActive on your site. Checkout Guard reads and blocks orders at the WooCommerce checkout, so it can’t run without it
LicenseA valid Checkout Guard license key and the email address used at purchase
Administrator or Shop manager accountBoth roles can open Checkout Guard and manage blocked entries. Other default WordPress roles don’t see the Checkout Guard menu

If WooCommerce isn’t active, Checkout Guard shows an admin notice on every screen telling you to install or activate it, with a direct link to do so. The plugin’s own settings screen won’t do anything useful until WooCommerce is active.

Step 1: Install and activate the plugin

Upload and activate Checkout Guard the same way you would any other WordPress plugin, either through Plugins → Add Plugin or by uploading the plugin ZIP file. Once it’s active, a new Checkout Guard item appears under the WooCommerce menu in your admin sidebar.

The WooCommerce admin menu with the Checkout Guard submenu item visible

Step 2: Activate your license

Go to WooCommerce → Checkout Guard, then click the Settings tab. Under License, enter your License Key and the Activation Email you used to purchase Checkout Guard. Then click Activate License (once your license has been activated, this button reads Re-activate License).

Once your license is active, the License status at the top of the section shows Active.

The Checkout Guard Settings tab showing the License section with empty License Key and Activation Email fields and a greyed-out Activate License button

Step 3: Add your first blocked entry

Checkout Guard blocks orders by matching a customer’s name, email, or IP address against a list of blocked entries you maintain. Go to the Blocked Entries tab (this is the default tab when you open Checkout Guard). On a fresh install, you’ll see an empty state that reads No blocked entries.

  1. Click Add First Entry (or Add Entry if you already have entries in the list). This opens the Add Blocked Entry dialog.
  2. Enter the customer’s First Name and Last Name if you’re blocking by name.
  3. Enter the customer’s Email Address if you’re blocking by email.
  4. Enter the customer’s IP Address if you’re blocking by IP. For the address formats Checkout Guard accepts, see How to block customers by IP address in Checkout Guard.
  5. Click Save Entry.

You don’t need to fill in every field. Checkout Guard only requires at least one of First Name, Last Name, Email Address, or IP Address to save an entry, so you can block by name alone, email alone, IP address alone, or any combination.

Add Blocked Entry dialog showing the First Name, Last Name, Email Address and IP Address fields with the wildcard hint under each one

Once saved, the entry appears in your Blocked Entries list. Any WooCommerce order attempting checkout with a matching name, email, or IP address is blocked automatically. There’s no separate “enable blocking” toggle to switch on. Adding an entry is what activates the block for that customer.

Step 4: Customize the checkout denial message

Still under the Settings tab, find Checkout Denial Message. This is the message a blocked customer sees when they try to place an order. Edit the text in the box, and a live Preview below it shows exactly how the message will look. Click Save Changes once you’re happy with it.

The Checkout Denial Message field with its preview, and the same message shown to a blocked customer at checkout

What’s next

Troubleshooting

I don’t see the Checkout Guard menu item
First, check your role. Only Administrator and Shop manager accounts see Checkout Guard. Any role your developer gives the WooCommerce management capability also sees it. If your account has another role, ask an Administrator to change it or to add the blocked entries for you. If your role is right, check WooCommerce next. Checkout Guard only registers its menu when WooCommerce is active. Go to Plugins → Installed Plugins and confirm WooCommerce shows as Active. If it’s missing entirely, install it from the WordPress.org plugin repository first.
Save Entry isn’t working
The Add Blocked Entry dialog requires at least one of First Name, Last Name, Email Address, or IP Address to be filled in before it saves. If all four are empty, add at least one and try again.
A blocked customer says they can’t check out and wants to know why
That’s expected. Once a name, email, or IP address matches a blocked entry, Checkout Guard stops that order at checkout and shows your Checkout Denial Message. If you no longer want to block that customer, remove their entry from the Blocked Entries list.

FAQ

Can I block a customer by email only, without their name?
Yes. Leave First Name and Last Name empty and enter only the Email Address. Checkout Guard matches on whichever fields you fill in.
Does blocking a customer cancel their existing orders?
No. Blocking only stops new orders at checkout going forward. It doesn’t change or cancel orders the customer already placed.
Can I edit or remove a blocked entry later?
Yes. Open the Blocked Entries tab to see your full list, where you can update or delete an entry at any time.

Need more help?

Checkout Guard is a licensed plugin, so if you run into trouble, open a support ticket and our team will help you get set up.

Was this article helpful?

Related Articles

Resources & Help