On this page
If you’re building an online store with WordPress, chances are you’ve come across WooCommerce—the platform powering millions of successful shops worldwide. It’s flexible, feature-packed, and works brilliantly for selling everything from physical products to digital downloads. But here’s something many store owners overlook: WooCommerce comes with a hidden superpower—shortcodes. These small, bracketed snippets let you instantly add store features anywhere on your site without writing a single line of code.
The beauty of WooCommerce shortcodes is in their versatility. You can use them to showcase best-selling items, create a tailored checkout page, embed your shopping cart on any landing page, or even spotlight specific product categories. They work in posts, pages, widgets—anywhere WordPress supports content. Whether you’re new to eCommerce and want quick customisation, a developer building unique layouts, or a business owner running time-sensitive promotions, shortcodes make it easy. And while adding features is important, keeping your store safe matters too—check out this guide on protecting your WooCommerce store from suspicious users and IP addresses to ensure your site runs smoothly. In this guide, we’ll cover how to use WooCommerce shortcodes, share practical WooCommerce shortcode examples, and reveal tips to get the most out of them.
What Are WooCommerce Shortcodes?
In WordPress, a shortcode is a small text snippet wrapped in square brackets that acts as an instruction for the system to display a specific feature or type of content. Instead of writing complicated code, you simply place the shortcode into a page, post, or widget, and WordPress replaces it with the intended output automatically.
WooCommerce takes this concept further by providing its own set of shortcodes designed specifically for online shops. These allow you to add dynamic store elements—such as product listings, shopping carts, checkout forms, or account pages—anywhere on your site.
Key differences between WordPress and WooCommerce shortcodes
WordPress shortcodes – General-purpose, can be used for things like image galleries, contact forms, or embedded videos.
WooCommerce shortcodes – Specialised for eCommerce, working directly with product data, cart systems, and checkout processes.
Advantages of using WooCommerce shortcodes
Time-saving – No need to build layouts from scratch or write PHP.
Beginner-friendly – Works with simple bracket syntax instead of coding.
Flexible placement – Can be added to posts, pages, widgets, and even custom templates.
Dynamic content – Automatically pulls live product data from your store.
For example, if you wanted to display four products in a grid on any page, you could simply use
[products limit="4" columns="4"]
This shortcode tells WooCommerce to show four products in four columns, perfect for a homepage section or promotional landing page. With just a few words in brackets, you can achieve results that would normally require a developer’s time and effort.
How to Use WooCommerce Shortcodes (Step-by-Step)
WooCommerce shortcodes are incredibly flexible and can be placed almost anywhere on your WordPress site. Whether you’re working in the Classic Editor, Gutenberg, or a page builder like Elementor or WPBakery, shortcodes make it easy to insert store features without any coding.
1. Where You Can Place Shortcodes
You can use WooCommerce shortcodes in a variety of locations, including:
Pages – Great for creating custom shop, checkout, or promotional landing pages.
Posts – Ideal for blog articles that promote specific products or sales.
Widgets – Add products or categories to sidebars and footers.
Gutenberg blocks – Insert shortcodes directly inside content blocks.
Page builders – Most modern builders have shortcode elements you can drag and drop.
This flexibility means you can display your store content exactly where you want it, rather than being limited to WooCommerce’s default layouts.
2. Adding Shortcodes in the Classic Editor vs. Gutenberg
Classic Editor:
Open the page or post where you want to display the WooCommerce element.
Paste the shortcode directly into the content area.
Update or publish the page to see the result.
Gutenberg Editor:
Click the + icon to add a new block.
Search for the Shortcode block and select it.
Paste your shortcode inside the block.
Preview or publish to see it in action.
3. Using Shortcodes with Elementor or WPBakery
Elementor:
Drag the Shortcode widget onto your page.
Paste your WooCommerce shortcode into the widget settings.
Style the surrounding layout with Elementor’s design tools.
WPBakery Page Builder:
Use the Raw HTML or Text Block element.
Paste your shortcode inside, save, and publish.
These page builders make it easy to combine WooCommerce functionality with custom designs, giving you full creative control.
4. Tips for Customising Shortcode Attributes
Most WooCommerce shortcodes have attributes—extra settings inside the shortcode that change how it works. For example:
[products limit="8" columns="4" category="t-shirts" orderby="date" order="DESC"]
Here’s what’s happening:
limit – Number of products to display.
columns – How many columns to show.
category – Only display products from a specific category.
orderby / order – Control the sorting (e.g., newest first).
You can combine multiple attributes to create highly targeted product displays.
5. Common Mistakes to Avoid
Incorrect spelling – Shortcodes must be typed exactly as shown, without spaces inside the brackets.
Using the wrong category slug – Ensure the category name matches its slug (lowercase, no spaces).
Forgetting to close the shortcode – While most WooCommerce shortcodes don’t require a closing tag, some do.
Using too many at once – Overloading a page with multiple product shortcodes can slow down performance.
Not checking mobile layouts – Shortcodes may look fine on desktop, but need adjustment for smaller screens.
Overview of Default WooCommerce Shortcodes:
| Shortcode | Description |
|---|
| [woocommerce_cart] | Displays the cart page. |
| [woocommerce_checkout] | Displays the checkout page. |
| [woocommerce_my_account] | Displays the user account page. |
| [woocommerce_order_tracking] | Displays the order tracking form; supports attributes. |
| [product_page] | Displays a full single product page by ID or SKU. |
| [products] | Displays multiple products based on parameters like category, tag, limit, and order. |
| [product_category] | Shows products from a specified category with customisable layout options. |
| [product_categories] | Displays a list or grid of product categories with optional filtering. |
| [add_to_cart] | Displays an “Add to Cart” button for a specific product with optional styling. |
| [add_to_cart_url] | Retrieves the URL for a product’s add-to-cart button; useful for custom links. |
| [shop_messages] | Shows WooCommerce system messages (e.g., errors, notices) on non-shop pages. |
| [featured_products] | Displays products marked as featured in a grid layout. |
| [sale_products] | Shows products currently on sale with customisable display options. |
| [best_selling_products] | Highlights your store’s best-selling products. |
| [top_rated_products] | Displays products with the highest customer ratings. |
| [recent_products] | Lists the most recently added products. |
| [related_products] | Shows products related to the current product being viewed. |
| [product_attribute] | Displays products filtered by a specific product attribute like color or size. |
List of Common WooCommerce Shortcodes
WooCommerce offers a range of shortcodes that help you add powerful eCommerce features to your WordPress site quickly and easily. These shortcodes work only if you have WooCommerce installed and activated on your website.
WooCommerce Cart Shortcodes:
1. Cart
[woocommerce_cart]
This shortcode displays the contents of the shopping cart, including product thumbnails, names, prices, quantities, and the subtotal. It supports several parameters that let you customise the output, such as columns, show_shipping, show_coupon, show_totals, and button_text.
Example: [woocommerce_cart columns="2" show_shipping="true" show_coupon="true" button_text="Proceed to Checkout"]
This will display the shopping cart with 2 columns, shipping options, a coupon code field, and a checkout button labeled “Proceed to Checkout”.
2. Cart Total
[woocommerce_cart_total]
This shortcode shows the total price of the shopping cart. You can customise it using parameters like class and before.
Example: [[woocommerce_cart_total class=”my-cart-total” before=”Total: “]]
This will display the cart total with a custom CSS class and the prefix “Total: ” before the amount.
3. Cart Coupon
[woocommerce_cart_coupon]
This shortcode adds a coupon code input field on the shopping cart page. It accepts parameters such as class and placeholder.
Example: [woocommerce_cart_coupon class=”my-cart-coupon” placeholder=”Enter coupon code”]
This will display the coupon field with a custom class and placeholder text “Enter coupon code”.
4. Cart Shipping
[woocommerce_cart_shipping]
This shortcode displays the shipping options available on the cart page. You can modify it using parameters like class and before.
Example: [[woocommerce_cart_shipping class=”my-cart-shipping” before=”Shipping: “]]
This will show the shipping methods with a custom class and the label “Shipping: ” before the options.
5. Cart Contents
[woocommerce_cart_contents]
This shortcode outputs the cart contents in a table format. It supports parameters such as class, before, and after to customise the HTML structure.
Example: [woocommerce_cart_contents class=”my-cart-contents” before=”<table>” after=”</table>”]
This will display the cart items inside a table with a custom class and custom HTML tags wrapping the content.
WooCommerce Checkout Shortcodes
1 Checkout
This shortcode displays the full checkout form with all necessary fields for customers to complete their purchase. It supports parameters like order_review, terms, privacy_policy, and login_form to customise the checkout experience.
Example: [woocommerce_checkout order_review="false" terms="true" privacy_policy="true" login_form="false"]
This will show the checkout form without the order review section but with the terms and privacy policy checkboxes enabled.
2. Checkout & Cart
[woocommerce_checkout_cart]
This shortcode displays the shopping cart contents on the checkout page. It includes parameters such as show_shipping, show_coupon, and show_cart to control which elements are visible.
Example: [[woocommerce_checkout_cart show_shipping=”true” show_coupon=”false” show_cart=”false”]]
This setup displays the cart contents with shipping options but hides the coupon code field and cart totals.
3. Checkout Order Review
[woocommerce_checkout_order_review]
This shortcode renders the order review section on the checkout page, including the product list, shipping details, and total cost. You can customise it with parameters like show_shipping, show_coupon, and show_cart.
Example: [[woocommerce_checkout_order_review show_shipping=”false” show_coupon=”false” show_cart=”false”]]
This example shows only the order review section without shipping, coupon, or cart details.
4. Checkout Fields
[woocommerce_checkout_fields]
Use this shortcode to display specific checkout fields such as billing and shipping addresses, payment methods, and order notes. Parameters include order, fields, and required to specify which fields appear and which are mandatory.
Example: [[woocommerce_checkout_fields order=”billing,shipping” fields=”first_name,last_name,email,phone” required=”first_name,last_name,email”]]
This will display billing and shipping fields for first name, last name, email, and phone, requiring the first name, last name, and email fields to be filled out.
WooCommerce Product Shortcodes: Detailed Guide with Examples
1. Products
[products]
This shortcode displays a grid of multiple products on your page, complete with pagination and sorting features. You can filter and customise the products shown by using various parameters such as:
category — show products from a specific category
tag — filter products by product tags
limit — number of products to display
columns — number of columns in the grid
orderby — sorting criteria (e.g., date, price, popularity)
order — ascending (asc) or descending (desc) order
Example:
[products limit="4" columns="2" orderby="price" order="asc"]
This shortcode will display 4 products arranged in 2 columns, sorted by price in ascending order (lowest price first).
2. Product Category
[product_category]
Use this shortcode to display products from a single product category. It shares many parameters with the [products] shortcode, letting you control the number of items, layout, and sorting.
category — slug of the product category
limit — how many products to show
columns — number of columns
orderby and order — sorting options
Example:
[product_category category="clothing" limit="6" columns="3"]
This will show 6 products from the “clothing” category arranged in 3 columns.
3. Products by SKU
[[products_by_sku]]
This shortcode lets you display specific products by listing their SKUs (Stock Keeping Units). It’s useful when you want to showcase particular items without relying on categories or tags.
Example:
[[products_by_sku skus="ABC123, DEF456, GHI789" limit="3"]]
This will display 3 products identified by the SKUs ABC123, DEF456, and GHI789.
4. Recent Products
[recent_products]
Displays your newest products in a grid. Parameters allow you to specify the number of items and their layout.
Example:
[recent_products limit="8" columns="4"]
This shortcode will show 8 recently added products arranged in 4 columns.
5. Best Selling Products
[best_selling_products]
Showcases your top-selling products, helping highlight popular choices in your store.
Example:
[best_selling_products limit="10" columns="5"]
Displays the top 10 best-selling products in 5 columns.
6. Single Product
[product]
Use this shortcode to display a single product on any page or post. You can identify the product by its ID or SKU.
id — product ID
sku — product SKU
Example:
[product id="123"]
This will show the product with the ID 123, including all its details like images, description, and price.
7. Product Attribute
[product_attribute]
Display products filtered by a specific attribute such as color, size, or material. This shortcode is handy for showcasing items sharing a particular characteristic.
attribute — the attribute name (e.g., color)
terms — attribute values to filter by (e.g., red)
operator — how to match terms (AND, OR)
limit — number of products
columns — number of columns
Example:
[product_attribute attribute="color" terms="red" operator="OR" limit="6" columns="3"]
This shows up to 6 products with the “red” color attribute in a 3-column grid.
8. Featured Products
[featured_products]
Displays products marked as featured in your WooCommerce store. Perfect for highlighting special items on your homepage or landing pages.
Example:
[featured_products limit="8" columns="4"]
This will display 8 featured products in 4 columns.
9. Product Tags
[[product_tags]]
This shortcode lists product tags with links to their archives, helping visitors browse products by tags.
exclude — IDs of tags to exclude
orderby — sort criteria (e.g., name, count)
order — ascending or descending
Example:
[[product_tags exclude="15,20" orderby="count" order="DESC"]]
This lists product tags ordered by the number of products, excluding tags with IDs 15 and 20.
10. Product Page
[product_page]
Embed a full product page for a specific product by ID anywhere on your site.
Example:
[product_page id="123"]
This displays the entire product page for product 123, including images, description, reviews, and purchase options.
11. Product Reviews
[[product_reviews]]
Shows a list of reviews for a specific product. You can limit how many reviews to display.
Example:
[[product_reviews id="123" limit="5"]]
This will display up to 5 reviews for product 123.
12. Product Description
[[woocommerce_product_description]]
Displays the description section of a product on your page.
13. Product Price
[[woocommerce_product_price]]
Shows the current price of a product.
WooCommerce Order Tracking and User Account Shortcodes
Order Tracking Form
[woocommerce_order_tracking]
This shortcode adds a simple, user-friendly form that allows customers to track the status of their orders directly on your website. By entering their order ID and billing email address, customers can quickly view updates such as shipping progress, delivery status, and order completion without needing to log in.
This feature improves customer experience by providing transparent order tracking and reducing support requests.
Example:
[woocommerce_order_tracking]
Simply place this shortcode on any page where you want customers to have access to order tracking. It will display a clean form with two input fields and a submit button.
User Account Dashboard
[woocommerce_my_account]
This shortcode creates the customer account dashboard, a secure area where registered users can manage their personal information and order history. It includes sections for:
Viewing recent and past orders
Downloading digital products
Editing billing and shipping addresses
Changing account passwords and details
Managing subscriptions (if applicable)
When users are not logged in, this shortcode automatically displays login and registration forms, making it easy for new and returning customers to access their accounts.
Example:
[woocommerce_my_account]
Add this shortcode to a page titled “My Account” or similar to provide customers with a seamless way to manage their profiles and orders.
How to Troubleshoot WooCommerce Shortcode Issues
If you’re encountering issues with WooCommerce shortcodes not functioning as expected, follow these steps to identify and resolve the problem:
Confirm WooCommerce is Installed and Activated
Make sure the WooCommerce plugin is installed and active on your WordPress site. Without WooCommerce, none of its shortcodes will work.
Verify Shortcode Syntax
Check that you’re using the correct shortcode syntax, including square brackets [ ] and proper parameters. Refer to the official WooCommerce documentation for guidance.
Check for Plugin Conflicts
Other plugins may interfere with WooCommerce shortcodes. Temporarily deactivate other plugins and test your shortcodes. If the problem resolves, reactivate plugins one by one to find the conflict. If you’re managing user roles or want to block unwanted users to reduce conflicts, consider tools like Blacklister for WooCommerce.
Switch to a Default Theme
Your active theme might be causing the issue. Switch to a default WordPress theme (like Twenty Twenty-One) temporarily to see if the shortcode works.
Clear Caches
Caching plugins or server caches may prevent updates from appearing. Clear all caches and reload your site.
Contact WooCommerce Support
If none of the above solves the issue, reach out to WooCommerce support for detailed help.
Frequently Asked Questions
How do I add WooCommerce shortcodes to my pages?
To add WooCommerce shortcodes, simply edit your WordPress page or post. If you’re using the Gutenberg editor, add a “Shortcode” block and paste the shortcode like [products]. For the Classic Editor, paste the shortcode directly where you want it to appear. When saved, the shortcode will show the corresponding WooCommerce content dynamically.
Can I use multiple WooCommerce shortcodes on the same page?
Yes, you can add multiple WooCommerce shortcodes on a single page to show different elements like product grids, the shopping cart, and the checkout form. Just ensure each shortcode is placed properly and they don’t visually conflict.
Why aren’t my WooCommerce shortcodes working?
Common reasons include the WooCommerce plugin not being activated, incorrect shortcode syntax, conflicts with other plugins or themes, or caching issues. Check these areas to fix the problem.
Can I customise which products are shown using shortcodes?
Yes, many product shortcodes support parameters like limit, columns, orderby, and category to control which products display and how they’re arranged.
How do I display products from a specific category?
Use the shortcode [product_category category="category-slug" limit="6" columns="3"], replacing “category-slug” with your actual product category name.
Can I add an Add to Cart button for a single product anywhere?
Yes! Use [add_to_cart id="123"], replacing 123 with the product ID, to add an Add to Cart button anywhere on your site.
Are WooCommerce shortcodes mobile-friendly?
Yes, WooCommerce shortcodes are designed to be responsive and adapt well to mobile devices.
Can I restrict shortcode content based on user roles?
WooCommerce doesn’t offer this natively, but you can use plugins or custom code to restrict shortcode visibility by user role.
WooCommerce Shortcodes List: Examples, Attributes, and Advanced Usage
/in BlogOn this page
If you’re building an online store with WordPress, chances are you’ve come across WooCommerce—the platform powering millions of successful shops worldwide. It’s flexible, feature-packed, and works brilliantly for selling everything from physical products to digital downloads. But here’s something many store owners overlook: WooCommerce comes with a hidden superpower—shortcodes. These small, bracketed snippets let you instantly add store features anywhere on your site without writing a single line of code.
The beauty of WooCommerce shortcodes is in their versatility. You can use them to showcase best-selling items, create a tailored checkout page, embed your shopping cart on any landing page, or even spotlight specific product categories. They work in posts, pages, widgets—anywhere WordPress supports content. Whether you’re new to eCommerce and want quick customisation, a developer building unique layouts, or a business owner running time-sensitive promotions, shortcodes make it easy. And while adding features is important, keeping your store safe matters too—check out this guide on protecting your WooCommerce store from suspicious users and IP addresses to ensure your site runs smoothly. In this guide, we’ll cover how to use WooCommerce shortcodes, share practical WooCommerce shortcode examples, and reveal tips to get the most out of them.
What Are WooCommerce Shortcodes?
In WordPress, a shortcode is a small text snippet wrapped in square brackets that acts as an instruction for the system to display a specific feature or type of content. Instead of writing complicated code, you simply place the shortcode into a page, post, or widget, and WordPress replaces it with the intended output automatically.
WooCommerce takes this concept further by providing its own set of shortcodes designed specifically for online shops. These allow you to add dynamic store elements—such as product listings, shopping carts, checkout forms, or account pages—anywhere on your site.
Key differences between WordPress and WooCommerce shortcodes
WordPress shortcodes – General-purpose, can be used for things like image galleries, contact forms, or embedded videos.
WooCommerce shortcodes – Specialised for eCommerce, working directly with product data, cart systems, and checkout processes.
Advantages of using WooCommerce shortcodes
Time-saving – No need to build layouts from scratch or write PHP.
Beginner-friendly – Works with simple bracket syntax instead of coding.
Flexible placement – Can be added to posts, pages, widgets, and even custom templates.
Dynamic content – Automatically pulls live product data from your store.
For example, if you wanted to display four products in a grid on any page, you could simply use
[products limit="4" columns="4"]
This shortcode tells WooCommerce to show four products in four columns, perfect for a homepage section or promotional landing page. With just a few words in brackets, you can achieve results that would normally require a developer’s time and effort.
How to Use WooCommerce Shortcodes (Step-by-Step)
WooCommerce shortcodes are incredibly flexible and can be placed almost anywhere on your WordPress site. Whether you’re working in the Classic Editor, Gutenberg, or a page builder like Elementor or WPBakery, shortcodes make it easy to insert store features without any coding.
1. Where You Can Place Shortcodes
You can use WooCommerce shortcodes in a variety of locations, including:
Pages – Great for creating custom shop, checkout, or promotional landing pages.
Posts – Ideal for blog articles that promote specific products or sales.
Widgets – Add products or categories to sidebars and footers.
Gutenberg blocks – Insert shortcodes directly inside content blocks.
Page builders – Most modern builders have shortcode elements you can drag and drop.
This flexibility means you can display your store content exactly where you want it, rather than being limited to WooCommerce’s default layouts.
2. Adding Shortcodes in the Classic Editor vs. Gutenberg
Classic Editor:
Open the page or post where you want to display the WooCommerce element.
Paste the shortcode directly into the content area.
Update or publish the page to see the result.
Gutenberg Editor:
Click the + icon to add a new block.
Search for the Shortcode block and select it.
Paste your shortcode inside the block.
Preview or publish to see it in action.
3. Using Shortcodes with Elementor or WPBakery
Elementor:
Drag the Shortcode widget onto your page.
Paste your WooCommerce shortcode into the widget settings.
Style the surrounding layout with Elementor’s design tools.
WPBakery Page Builder:
Use the Raw HTML or Text Block element.
Paste your shortcode inside, save, and publish.
These page builders make it easy to combine WooCommerce functionality with custom designs, giving you full creative control.
4. Tips for Customising Shortcode Attributes
Most WooCommerce shortcodes have attributes—extra settings inside the shortcode that change how it works. For example:
[products limit="8" columns="4" category="t-shirts" orderby="date" order="DESC"]Here’s what’s happening:
limit – Number of products to display.
columns – How many columns to show.
category – Only display products from a specific category.
orderby / order – Control the sorting (e.g., newest first).
You can combine multiple attributes to create highly targeted product displays.
5. Common Mistakes to Avoid
Incorrect spelling – Shortcodes must be typed exactly as shown, without spaces inside the brackets.
Using the wrong category slug – Ensure the category name matches its slug (lowercase, no spaces).
Forgetting to close the shortcode – While most WooCommerce shortcodes don’t require a closing tag, some do.
Using too many at once – Overloading a page with multiple product shortcodes can slow down performance.
Not checking mobile layouts – Shortcodes may look fine on desktop, but need adjustment for smaller screens.
Overview of Default WooCommerce Shortcodes:
List of Common WooCommerce Shortcodes
WooCommerce offers a range of shortcodes that help you add powerful eCommerce features to your WordPress site quickly and easily. These shortcodes work only if you have WooCommerce installed and activated on your website.
WooCommerce Cart Shortcodes:
1. Cart
[woocommerce_cart]
This shortcode displays the contents of the shopping cart, including product thumbnails, names, prices, quantities, and the subtotal. It supports several parameters that let you customise the output, such as columns, show_shipping, show_coupon, show_totals, and button_text.
Example: [woocommerce_cart columns="2" show_shipping="true" show_coupon="true" button_text="Proceed to Checkout"]
This will display the shopping cart with 2 columns, shipping options, a coupon code field, and a checkout button labeled “Proceed to Checkout”.
2. Cart Total
[woocommerce_cart_total]
This shortcode shows the total price of the shopping cart. You can customise it using parameters like class and before.
Example: [[woocommerce_cart_total class=”my-cart-total” before=”Total: “]]
This will display the cart total with a custom CSS class and the prefix “Total: ” before the amount.
3. Cart Coupon
[woocommerce_cart_coupon]
This shortcode adds a coupon code input field on the shopping cart page. It accepts parameters such as class and placeholder.
Example: [woocommerce_cart_coupon class=”my-cart-coupon” placeholder=”Enter coupon code”]
This will display the coupon field with a custom class and placeholder text “Enter coupon code”.
4. Cart Shipping
[woocommerce_cart_shipping]
This shortcode displays the shipping options available on the cart page. You can modify it using parameters like class and before.
Example: [[woocommerce_cart_shipping class=”my-cart-shipping” before=”Shipping: “]]
This will show the shipping methods with a custom class and the label “Shipping: ” before the options.
5. Cart Contents
[woocommerce_cart_contents]
This shortcode outputs the cart contents in a table format. It supports parameters such as class, before, and after to customise the HTML structure.
Example: [woocommerce_cart_contents class=”my-cart-contents” before=”<table>” after=”</table>”]
This will display the cart items inside a table with a custom class and custom HTML tags wrapping the content.
WooCommerce Checkout Shortcodes
1 Checkout
This shortcode displays the full checkout form with all necessary fields for customers to complete their purchase. It supports parameters like
order_review,terms,privacy_policy, andlogin_formto customise the checkout experience.Example: [woocommerce_checkout order_review="false" terms="true" privacy_policy="true" login_form="false"]
This will show the checkout form without the order review section but with the terms and privacy policy checkboxes enabled.
2. Checkout & Cart
[woocommerce_checkout_cart]
This shortcode displays the shopping cart contents on the checkout page. It includes parameters such as
show_shipping,show_coupon, andshow_cartto control which elements are visible.Example: [[woocommerce_checkout_cart show_shipping=”true” show_coupon=”false” show_cart=”false”]]
This setup displays the cart contents with shipping options but hides the coupon code field and cart totals.
3. Checkout Order Review
[woocommerce_checkout_order_review]
This shortcode renders the order review section on the checkout page, including the product list, shipping details, and total cost. You can customise it with parameters like
show_shipping,show_coupon, andshow_cart.Example: [[woocommerce_checkout_order_review show_shipping=”false” show_coupon=”false” show_cart=”false”]]
This example shows only the order review section without shipping, coupon, or cart details.
4. Checkout Fields
[woocommerce_checkout_fields]
Use this shortcode to display specific checkout fields such as billing and shipping addresses, payment methods, and order notes. Parameters include
order,fields, andrequiredto specify which fields appear and which are mandatory.Example: [[woocommerce_checkout_fields order=”billing,shipping” fields=”first_name,last_name,email,phone” required=”first_name,last_name,email”]]
This will display billing and shipping fields for first name, last name, email, and phone, requiring the first name, last name, and email fields to be filled out.
WooCommerce Product Shortcodes: Detailed Guide with Examples
1. Products
[products]This shortcode displays a grid of multiple products on your page, complete with pagination and sorting features. You can filter and customise the products shown by using various parameters such as:
category — show products from a specific category
tag — filter products by product tags
limit — number of products to display
columns — number of columns in the grid
orderby — sorting criteria (e.g., date, price, popularity)
order — ascending (asc) or descending (desc) order
Example:
[products limit="4" columns="2" orderby="price" order="asc"]This shortcode will display 4 products arranged in 2 columns, sorted by price in ascending order (lowest price first).
2. Product Category
[product_category]Use this shortcode to display products from a single product category. It shares many parameters with the
[products]shortcode, letting you control the number of items, layout, and sorting.category — slug of the product category
limit — how many products to show
columns — number of columns
orderby and order — sorting options
Example:
[product_category category="clothing" limit="6" columns="3"]This will show 6 products from the “clothing” category arranged in 3 columns.
3. Products by SKU
[[products_by_sku]]This shortcode lets you display specific products by listing their SKUs (Stock Keeping Units). It’s useful when you want to showcase particular items without relying on categories or tags.
skus — comma-separated list of product SKUs
limit — maximum number of products to display
Example:
[[products_by_sku skus="ABC123, DEF456, GHI789" limit="3"]]This will display 3 products identified by the SKUs ABC123, DEF456, and GHI789.
4. Recent Products
[recent_products]Displays your newest products in a grid. Parameters allow you to specify the number of items and their layout.
limit — number of recent products to show
columns — number of columns
Example:
[recent_products limit="8" columns="4"]This shortcode will show 8 recently added products arranged in 4 columns.
5. Best Selling Products
[best_selling_products]Showcases your top-selling products, helping highlight popular choices in your store.
limit — how many best sellers to display
columns — grid layout columns
Example:
[best_selling_products limit="10" columns="5"]Displays the top 10 best-selling products in 5 columns.
6. Single Product
[product]Use this shortcode to display a single product on any page or post. You can identify the product by its ID or SKU.
id — product ID
sku — product SKU
Example:
[product id="123"]This will show the product with the ID 123, including all its details like images, description, and price.
7. Product Attribute
[product_attribute]Display products filtered by a specific attribute such as color, size, or material. This shortcode is handy for showcasing items sharing a particular characteristic.
attribute — the attribute name (e.g., color)
terms — attribute values to filter by (e.g., red)
operator — how to match terms (AND, OR)
limit — number of products
columns — number of columns
Example:
[product_attribute attribute="color" terms="red" operator="OR" limit="6" columns="3"]This shows up to 6 products with the “red” color attribute in a 3-column grid.
8. Featured Products
[featured_products]Displays products marked as featured in your WooCommerce store. Perfect for highlighting special items on your homepage or landing pages.
limit — number of featured products to show
columns — layout columns
Example:
[featured_products limit="8" columns="4"]This will display 8 featured products in 4 columns.
9. Product Tags
[[product_tags]]This shortcode lists product tags with links to their archives, helping visitors browse products by tags.
exclude — IDs of tags to exclude
orderby — sort criteria (e.g., name, count)
order — ascending or descending
Example:
[[product_tags exclude="15,20" orderby="count" order="DESC"]]This lists product tags ordered by the number of products, excluding tags with IDs 15 and 20.
10. Product Page
[product_page]Embed a full product page for a specific product by ID anywhere on your site.
id — product ID
Example:
[product_page id="123"]This displays the entire product page for product 123, including images, description, reviews, and purchase options.
11. Product Reviews
[[product_reviews]]Shows a list of reviews for a specific product. You can limit how many reviews to display.
id — product ID
limit — number of reviews
Example:
[[product_reviews id="123" limit="5"]]This will display up to 5 reviews for product 123.
12. Product Description
[[woocommerce_product_description]]Displays the description section of a product on your page.
13. Product Price
[[woocommerce_product_price]]Shows the current price of a product.
WooCommerce Order Tracking and User Account Shortcodes
Order Tracking Form
[woocommerce_order_tracking]This shortcode adds a simple, user-friendly form that allows customers to track the status of their orders directly on your website. By entering their order ID and billing email address, customers can quickly view updates such as shipping progress, delivery status, and order completion without needing to log in.
This feature improves customer experience by providing transparent order tracking and reducing support requests.
Example:
[woocommerce_order_tracking]Simply place this shortcode on any page where you want customers to have access to order tracking. It will display a clean form with two input fields and a submit button.
User Account Dashboard
[woocommerce_my_account]This shortcode creates the customer account dashboard, a secure area where registered users can manage their personal information and order history. It includes sections for:
Viewing recent and past orders
Downloading digital products
Editing billing and shipping addresses
Changing account passwords and details
Managing subscriptions (if applicable)
When users are not logged in, this shortcode automatically displays login and registration forms, making it easy for new and returning customers to access their accounts.
Example:
[woocommerce_my_account]Add this shortcode to a page titled “My Account” or similar to provide customers with a seamless way to manage their profiles and orders.
How to Troubleshoot WooCommerce Shortcode Issues
If you’re encountering issues with WooCommerce shortcodes not functioning as expected, follow these steps to identify and resolve the problem:
Confirm WooCommerce is Installed and Activated
Make sure the WooCommerce plugin is installed and active on your WordPress site. Without WooCommerce, none of its shortcodes will work.
Verify Shortcode Syntax
Check that you’re using the correct shortcode syntax, including square brackets
[ ]and proper parameters. Refer to the official WooCommerce documentation for guidance.Check for Plugin Conflicts
Other plugins may interfere with WooCommerce shortcodes. Temporarily deactivate other plugins and test your shortcodes. If the problem resolves, reactivate plugins one by one to find the conflict. If you’re managing user roles or want to block unwanted users to reduce conflicts, consider tools like Blacklister for WooCommerce.
Switch to a Default Theme
Your active theme might be causing the issue. Switch to a default WordPress theme (like Twenty Twenty-One) temporarily to see if the shortcode works.
Clear Caches
Caching plugins or server caches may prevent updates from appearing. Clear all caches and reload your site.
Contact WooCommerce Support
If none of the above solves the issue, reach out to WooCommerce support for detailed help.
Frequently Asked Questions
How do I add WooCommerce shortcodes to my pages?
To add WooCommerce shortcodes, simply edit your WordPress page or post. If you’re using the Gutenberg editor, add a “Shortcode” block and paste the shortcode like [products]. For the Classic Editor, paste the shortcode directly where you want it to appear. When saved, the shortcode will show the corresponding WooCommerce content dynamically.
Can I use multiple WooCommerce shortcodes on the same page?
Yes, you can add multiple WooCommerce shortcodes on a single page to show different elements like product grids, the shopping cart, and the checkout form. Just ensure each shortcode is placed properly and they don’t visually conflict.
Why aren’t my WooCommerce shortcodes working?
Common reasons include the WooCommerce plugin not being activated, incorrect shortcode syntax, conflicts with other plugins or themes, or caching issues. Check these areas to fix the problem.
Can I customise which products are shown using shortcodes?
Yes, many product shortcodes support parameters like limit, columns, orderby, and category to control which products display and how they’re arranged.
How do I display products from a specific category?
Use the shortcode [product_category category="category-slug" limit="6" columns="3"], replacing “category-slug” with your actual product category name.
Can I add an Add to Cart button for a single product anywhere?
Yes! Use [add_to_cart id="123"], replacing 123 with the product ID, to add an Add to Cart button anywhere on your site.
Are WooCommerce shortcodes mobile-friendly?
Yes, WooCommerce shortcodes are designed to be responsive and adapt well to mobile devices.
Can I restrict shortcode content based on user roles?
WooCommerce doesn’t offer this natively, but you can use plugins or custom code to restrict shortcode visibility by user role.
WooCommerce Country Codes: Essential Guide for E-commerce Stores
/in BlogWhat is a WooCommerce country code? A WooCommerce country code is a two-letter ISO 3166-1 alpha-2 code (for example, US for the United States, GB for the United Kingdom, DE for Germany) that WooCommerce uses to identify billing, shipping and tax locations. WooCommerce ships with all 249 official country codes and updates them with each release.
If you’re running an online store with WooCommerce, you’ve probably encountered country codes. But what exactly are they? Simply put, a country code is a short, standardised abbreviation (usually two letters) that represents a specific country, like US for the United States or GB for Great Britain. WooCommerce uses these codes behind the scenes to identify where your customers are from, which helps it calculate shipping costs, taxes, and even the checkout options that appear during a purchase. These country codes make it easier for your store to handle international orders smoothly without confusion or errors.
WooCommerce is one of the leading e-commerce platforms, loved for its flexibility and powerful features that support selling worldwide. Thanks to the use of country codes, it lets you set up shipping zones, tax rules, and payment methods tailored precisely to different countries and regions. This means you can offer your customers accurate prices and shipping times no matter where they live.
Alongside country codes, WooCommerce also uses state or region codes, which work the same way but at a more detailed level. For example, in the US or Canada, different states or provinces may have different tax rates or shipping rules, and these codes help WooCommerce handle those details properly.
In this guide, you’ll learn everything about WooCommerce country codes: what they are, how to use them, and why they’re so important for running a smooth, professional online store that sells internationally.
What Are WooCommerce Country Codes?
When managing an online store with WooCommerce, country codes play an essential role in organising your sales and shipping across different countries. At their core, country codes are short, standardised abbreviations that represent countries worldwide. WooCommerce uses the internationally recognised ISO 3166-1 alpha-2 standard for these codes, which consists of two capital letters—such as GB for the United Kingdom, FR for France, and DE for Germany.
These codes are more than just labels. WooCommerce relies on them internally to:
Understanding the difference between country codes and state codes is also important. While country codes represent entire nations, state codes (or region codes) refer to subdivisions within those countries. For example, in the United States, US is the country code, while CA stands for California, a state within the US. Similarly, in Canada, CA is the country code, and ON is the code for Ontario. WooCommerce uses both to allow store owners to set precise shipping rules or tax rates that may differ between states, provinces, or regions.
Why Accurate Country Codes Matter
Using accurate country codes is crucial for your store’s smooth operation and customer satisfaction. Here’s why:
In short, country codes are the backbone of WooCommerce’s international functionality. Ensuring they are set up properly helps you manage your global store efficiently, keeps customers happy, and keeps your business compliant with different country regulations.
List of Supported WooCommerce Country Codes
WooCommerce supports a comprehensive set of country codes based on the ISO 3166-1 alpha-2 standard. These two-letter codes allow WooCommerce to precisely identify countries for shipping, taxes, and checkout processes. Having a clear, up-to-date list of supported country codes is essential for store owners, especially those selling internationally.
Below is an alphabetised table of WooCommerce-supported country codes and their corresponding countries. This list forms the basis for WooCommerce’s shipping zones, tax calculations, and more.
How Is This List Maintained and Updated?
WooCommerce regularly updates its country code list to stay aligned with the official ISO 3166-1 alpha-2 standard maintained by the International Organization for Standardization (ISO). Changes can happen if countries rename, merge, split, or new territories are recognised. WooCommerce reflects these updates in their codebase through periodic software updates and patches.
For store owners, this means that keeping WooCommerce up to date will usually ensure your country code list remains current without manual intervention.
How to Access This List Within WooCommerce
If you want to see or work directly with the list of country codes WooCommerce supports, you can access it in several ways:
Programmatically: If you are developing custom code or plugins, WooCommerce provides functions to retrieve the country list, such as:
php
CopyEdit
WC()->countries->get_countries();
WooCommerce State Codes and Their Importance
Just as WooCommerce uses country codes to identify nations, it also relies on state codes to represent subdivisions within those countries—such as states, provinces, regions, or territories. These codes follow the ISO 3166-2 standard, which defines codes for the principal subdivisions of all countries coded in ISO 3166-1.
State codes are crucial in WooCommerce for several reasons:
Because these subdivisions vary widely across countries, WooCommerce allows you to customise or add state codes based on your target markets.
List of WooCommerce State Codes:-
Albanian (AL) states
Angolan (AO) States
Argentinian (AR) Provinces
Australian (AU) States
Bangladeshi (BD) Districts
Bulgarian (BG) States
Beninese (BJ) States
Bolivian (BO) States
Brazilian (BR) States
Canadian (CA) Provinces and Territories
Algerian (DZ) States
Ecuadorian (EC) States
Egyptian (EG) States
Spanish (ES) States
Ghanaian (GH) Regions
Greek (GR) Regions
Guatemalan (GT) States
Hong Kong (HK) States
Honduran (HN) States
Hungarian (HU) States
Indonesian (ID) Provinces
Irish (IE) States
Indian (IN) States
Iranian (IR) States
Italian (IT) Provinces
Amaican (JM) parishes
Japanese (JP) prefectures
Kenyan (KE) counties
Laotian (LA) provinces
Liberian (LR) provinces
Moldovan (MD) states
Mexican (MX) states
Malaysian (MY) states
Mozambican (MZ) provinces
Namibian (NA) regions
Nigerian (NG) provinces
Nepalese (NP) zones
Nicaraguan (NI) states
New Zealand (NZ) states
Panamanian (PA) states
Peruvian (PE) states
Philippine (PH) provinces
Pakistani (PK) states
Paraguayan (PY) states
Romanian (RO) states
Salvadoran (SV) states
Thai (TH) states
Turkish (TR) states
Tanzanian (TZ) states
Serbian (RS) districts
Ukrainian (UA) oblasts
Ugandan (UG) districts
United States Minor Outlying Islands (UM)
United States (US) states
Uruguayan (UY) states
Venezuelan (VE) states
South African (ZA) states
Zambian (ZM) provinces
How to Use WooCommerce Country Codes in Your Store
When customers visit your WooCommerce store and proceed to checkout, the default country and state must be set correctly to provide a smooth experience.
By default, WooCommerce uses your store address to guess the customer’s location. However, you can explicitly set the default country and state to match your primary market or most frequent customer base. This helps reduce friction and speeds up the checkout process.
How to set it:
Using the correct country and state codes ensures the checkout fields are pre-filled with the right default values, enhancing the user experience.
Restricting Sales to Specific Countries or States Using Country Codes
If you want to restrict where you sell or ship products, WooCommerce allows you to limit sales to specific countries — or even states — using country/state codes.
Why restrict sales?
How to set it:
Adding Custom Countries or States (Step-by-Step Guide)
Sometimes you may want to add custom countries or states not available in WooCommerce by default — e.g., territories or special regions.
Step 1: Add a custom country
add_filter( 'woocommerce_countries', 'add_custom_country' );function add_custom_country( $countries ){$countries['XX'] = 'Customland'; // 'XX' = new country codereturn $countries;<
span style="font-weight: 400;">}Step 2: Add states to that custom country
add_filter( 'woocommerce_states', 'add_custom_country_states' );function add_custom_country_states( $states ) {$states['XX'] = array('XX-01' => 'Custom State 1','XX-02' => 'Custom State 2',);return $states;}Step 3: Use them in WooCommerce settings
Your custom country and states will now show up throughout WooCommerce — including checkout, shipping zones, and tax rules.
Modifying Country or State Names Shown to Users
You can also change how country or state names appear to customers — ideal for localization, branding, or translations.
Rename a country’s display name:
add_filter( 'woocommerce_countries', 'modify_country_names' );function modify_country_names( $countries ) {if ( isset( $countries['US'] ) ) {$countries['US'] = 'United States of Awesome';}return $countries;}Rename a state’s display name:
add_filter( 'woocommerce_states', 'modify_state_names' );function modify_state_names( $states ) {if ( isset( $states['US']['CA'] ) ) {$states['US']['CA'] = 'California Dreamin\'';}return $states;}Using Country Codes in Shipping & Tax Plugins
Most WooCommerce shipping and tax plugins rely on country and state codes to work properly.
Examples include:
Using official ISO country and state codes ensures compatibility and prevents configuration errors.
How to Identify and Block High-Risk Users in WooCommerce
/in BlogAs eCommerce continues to grow, so do the risks, especially for WooCommerce store owners. From fraudulent transactions to fake accounts, the threats are becoming more frequent and sophisticated. Without proper protections in place, these high-risk users can drain revenue, waste resources, and damage your store’s reputation.
That’s why it’s critical to identify and block high-risk users in WooCommerce early in the process. Doing so helps protect your store, streamline operations, and maintain customer trust.
The goal of this article is simple: to show you how to detect high-risk users in WooCommerce and implement automated strategies to block high-risk users in WooCommerce before they cause harm.
What is a High-Risk User in WooCommerce?
A high-risk user is someone who poses a strong likelihood of committing fraud or abusing your store’s features. These users may exploit vulnerabilities to steal, scam, or disrupt your operations.
Common Examples of High-Risk Users:
Users with fake or stolen payment details — leading to chargebacks and loss of revenue.
Customers are abusing return or refund policies by making false claims or exploiting loopholes.
Bots that create fake accounts or place spam orders, adding strain to your system and skewing analytics.
Repeat offenders using known blacklisted information, such as flagged IPs, emails, or phone numbers.
Common Signs of High-Risk Behavior
Detecting high-risk users early starts with recognising the warning signs. While some behaviors may seem harmless in isolation, patterns often reveal fraudulent intent. Here are the most common red flags to watch for in your WooCommerce store:
Multiple Failed Login or Checkout Attempts
Repeated login failures or unsuccessful payment attempts may indicate bot activity or someone testing stolen credentials.
Mismatched Billing and Shipping Addresses
Orders where the billing and shipping details don’t align—especially across different countries—can signal potential fraud.
Suspicious Email Domains
Temporary or disposable email addresses (e.g., *@tempmail.com, *@mailinator.com) are commonly used by fraudsters to avoid detection and bypass account verification.
Known Blacklisted IPs or Countries
Orders originating from flagged IP addresses or high-risk regions are often linked to scams, fraud rings, or automated attacks. Blocking users by IP address can help reduce this threat.
Unusually Large or Repeated Orders
Large-value orders placed without a purchase history—or multiple identical orders in a short timeframe—can be signs of account compromise or payment fraud.
Abnormal Customer Behavior
Activities such as placing many low-value “test” orders or rapidly switching addresses and payment methods are strong indicators of automated fraud attempts or system probing.
Identifying these behaviors early allows you to take preventive action before a fraudulent order impacts your revenue or reputation.
Tools and Techniques to Identify High-Risk Users
To protect your WooCommerce store from fraud, you need more than just intuition—you need the right tools. Combining automated systems with manual checks can help you identify and block high-risk users before they cause damage.
1. Fraud Scoring Systems
Plugins like FraudLabs Pro, WooCommerce Anti-Fraud, and similar tools analyse each order using fraud scoring. They assess factors such as IP address, email domain, billing/shipping mismatch, and more, then assign a risk score to help you decide whether to accept, review, or reject the order.
2. Behavior Monitoring
Tracking user behavior—such as failed login attempts, unusual cart activity, or multiple sessions from the same IP—can uncover suspicious patterns early. Many security plugins offer dashboards or logs to monitor this behavior in real-time.
3. IP Geolocation and VPN/Proxy Detection
Fraudsters often hide behind VPNs or proxies to disguise their location. Using geolocation tools helps detect when orders originate from unexpected or high-risk regions. This data can be used to trigger alerts or automatic blocks.
4. Email and Phone Validation Tools
Temporary and disposable emails are a red flag. Use validation tools that check the email domain reputation or block known temporary domains. For guidance on email blocking, refer to this step-by-step guide on blocking email addresses in WooCommerce. Similarly, validating phone numbers—especially international or non-mobile ones—can also filter out risky users.
5. Manual Order Review and Pattern Recognition
Sometimes, human intuition catches what automation misses. Reviewing high-risk orders manually and identifying patterns—such as repeat offenses or frequent address changes—can help you refine your fraud detection rules over time.
How to Block High-Risk Users in WooCommerce
When running a WooCommerce store, identifying high-risk users is only half the battle—blocking them effectively is what truly protects your revenue and operations. One of the most reliable ways to do this is by using a dedicated security plugin like Aelia Blacklister for WooCommerce, which enables precise and flexible blacklisting based on user behavior and data.
Why Use Aelia Blacklister?
Aelia Blacklister helps WooCommerce store owners proactively block fraudulent customers before they can complete an order. It allows you to blacklist users based on IP addresses, email addresses, phone numbers, physical addresses, and even names, using both exact and partial matches. You can stop fake orders, prevent abuse of return policies, and block suspicious users at checkout.
How to Configure Aelia Blacklister Plugin
Setting up Aelia Blacklister for WooCommerce is simple and intuitive, even for non-technical users. Here’s a step-by-step guide:
Step 1: Download and Install the Aelia Blacklister Plugin
Part 1: Download the Plugin
Visit the Official Aelia Website
Head to aelia.co and navigate to the Aelia Blacklister plugin page to get the most recent and secure version.
Purchase or Access the Plugin
If the plugin is paid, complete your purchase to access the download link.
Download the ZIP Archive
Click the Download button to save the plugin ZIP file to your computer. This file contains everything needed for installation.
Part 2: Upload the Plugin to Your WordPress Site
Log in to WordPress Admin
Access your WordPress admin dashboard.
Go to Plugins > Add New
From the left-hand menu, hover over Plugins, then click Add New.
Click ‘Upload Plugin’
At the top of the page, click the Upload Plugin button.
Select the ZIP File
Click Choose File, locate the downloaded Aelia Blacklister ZIP file, and select it.
Install the Plugin
Click Install Now to upload and install the plugin.
Part 3: Activate the Plugin
Wait for Installation to Finish
Once installed, WordPress will show a confirmation message.
Activate the Plugin
Click Activate Plugin to enable Aelia Blacklister.
Verify Activation
After activation, you’ll find the plugin listed under active plugins and see a new settings section in WooCommerce > Aelia Blacklister.
Step 2: Configure Blocking Rules in Aelia Blacklister
Now that the plugin is installed, it’s time to configure your blacklist rules to stop high-risk users from placing orders.
1. Block by Name and Surname
How to Block:
Go to the blacklist settings and input the full names, first names, or surnames you wish to block.
Why It Matters:
Fraudsters may change emails or IPs, but often reuse the same names. Blocking by name helps catch repeat offenders.
Steps:
Open the Blacklist Customer section.
Add names to the blacklist.
Click Save Changes.
2. Block by Address (Street, Postcode, City, State, Country)
How to Block:
Target specific address components like street name, postal code, or country.
Why It Matters:
Fake or stolen addresses from high-risk regions are often reused by fraudsters.
Steps:
Navigate to the Address section.
Enter full or partial addresses.
Choose blocking levels (e.g., region, postcode).
Click Save.
3. Block by Email Address
How to Block:
Enter full email addresses or entire domains (e.g., *@tempmail.com).
Why It Matters:
Disposable and fake emails are commonly used to bypass security.
Steps:
Go to the Email Address field.
Add the emails or domains.
Save the settings.
4. Block by Phone Number
How to Block:
Input full numbers or area codes commonly linked to fraud.
Why It Matters:
Fake or stolen phone numbers are often tied to suspicious orders.
Steps:
Go to the Phone Number section.
Add the numbers or codes.
Save the configuration.
5. Block by IP Address
How to Block:
Use exact IPs, wildcards (e.g.,
192.168.*.*), or regex to match patterns.Why It Matters:
Fraudsters may return under the same IP or a known range. Blocking IPs prevents repeat access.
Steps:
Access the IP Address section.
Enter specific IPs or ranges.
Apply regex patterns for advanced control.
Click Save.
Final Step: Save and Activate Your Rules
After adding all your blocking criteria, ensure you click Save or Update in the plugin settings.
Regularly reviewing and updating your blacklist will help you stay ahead of new fraud attempts.
Enhance Your Store Security with Complementary Tools
While Aelia Blacklister offers robust blocking capabilities to protect your WooCommerce store from fraudulent orders, you can take your store’s security and overall performance even further by integrating additional solutions from Aelia.
For example, the Prices by Country for WooCommerce plugin is a powerful companion tool. It enables you to display tailored pricing based on the visitor’s location, simplifying international sales management and reducing risks associated with currency fluctuations or regional pricing abuses. Combining these tools helps you create a safer, smarter, and more efficient WooCommerce store.
Blocking Repeat Offenders in WooCommerce:Protecting Your Store
/in BlogManaging a WooCommerce store comes with many challenges, but one of the most persistent issues is dealing with repeat offenders. These are customers or bad actors who repeatedly attempt fraudulent activities—placing fake orders, abusing store policies, or exploiting loopholes. Such repeated fraud not only drains your revenue but also disrupts daily operations, from inventory management to customer service. That’s why WooCommerce Protecting Your Store isn’t just a best practice—it’s a necessity for maintaining business stability and customer trust.
Repeat fraudsters can lead to chargebacks, lost products, and wasted time verifying orders—costs that add up quickly and threaten the profitability of your business. This makes proactive blocking strategies crucial. By identifying and stopping these offenders early, you safeguard your store, protect your genuine customers, and maintain a healthy bottom line.
Who Are Repeat Offenders?
Repeat offenders come in many forms, each causing unique challenges for your WooCommerce store:
Customers placing multiple fraudulent orders often use stolen credit cards or fake details to repeatedly make purchases.
Users exploiting coupons or return policies take advantage of your store’s offers or return process to get free or discounted products unfairly.
Bots or bad actors testing stolen credentials try to access accounts or place orders by repeatedly using compromised login information.
These activities lead to revenue loss, operational disruptions, and can harm your store’s reputation. To effectively combat this, it’s essential to implement proactive blocking strategies.
One powerful method is to block users by their IP addresses, which can prevent known offenders from accessing your store entirely. If you want to learn how to set this up in WooCommerce, check out this quick guide on blocking users by IP address.
Risks and Consequences of Repeat Offenders
Repeat offenders can have a serious impact on your WooCommerce store, including:
Financial loss due to chargebacks, refunds, and lost sales.
Inventory theft and product loss from fraudulent orders that never pay or are falsely returned.
Increased workload as your team spends more time reviewing suspicious orders and handling disputes.
Damage to your store’s reputation and loss of customer trust when fraud goes unchecked.
Why WooCommerce Default Features Are Insufficient
While WooCommerce offers many essential tools, its default features fall short when it comes to effectively managing repeat offenders:
There is no built-in mechanism to track or automatically block repeat offenders based on user behavior or details.
Manual detection is time-consuming, error-prone, and often ineffective at stopping determined fraudsters.
WooCommerce provides limited control over blocking users by specific patterns, such as repeated use of fraudulent email addresses or abusive accounts.
To strengthen your defenses, consider enhanced blocking options like email filtering. Learn how to block suspicious or malicious email addresses effectively with this detailed guide on blocking email addresses in WooCommerce.
Strategies to Block Repeat Offenders in WooCommerce
Protecting your WooCommerce store from repeat offenders requires a multi-layered approach. Here are some effective strategies you can implement:
Use Security and Anti-Fraud Plugins: Leverage specialised plugins designed to detect and block fraudulent activity automatically, saving you time and reducing risk.
Implement Blacklist Rules: Set up blocking based on IP addresses, email addresses, phone numbers, and physical addresses to stop known offenders from placing orders.
Apply Login Security Measures: Enhance account security by enabling two-factor authentication (2FA) and CAPTCHA challenges to prevent bots and unauthorised access.
Monitor Suspicious Order Patterns: Keep an eye on unusual purchasing behavior, such as multiple orders from the same IP or email, and set limits to prevent abuse.
Use Order Review and Manual Approval: For higher-risk orders, introduce a manual review process to verify legitimacy before processing payment or shipping.
By combining these strategies, you can significantly reduce fraudulent transactions and protect your store’s revenue and reputation.
Spotlight on Effective Tools: Aelia Blacklister for WooCommerce
When it comes to blocking repeat offenders and securing your WooCommerce store, Aelia Blacklister for WooCommerce stands out as a powerful and user-friendly solution. Here’s how it helps you protect your business from fraudulent users and malicious activity:
Blacklisting Based on User Data
Aelia Blacklister allows you to block users by a variety of data points, including:
Name: Block specific first names, last names, or full names that have been linked to fraudulent behavior.
Email Address: Prevent orders from suspicious or disposable email addresses, or block entire domains to cut off groups of fraudsters.
Phone Number: Stop orders from known fraudulent phone numbers or area codes linked to abuse.
IP Address: Block single IP addresses or entire IP ranges that have been used in previous fraud attempts.
This comprehensive approach gives you multiple layers of defense, targeting offenders regardless of how they try to disguise themselves.
Customizable Rules with Exact and Partial Matches
The plugin lets you create flexible blacklisting rules:
Exact Matches: Block an exact name, email, or IP to stop a known offender immediately.
Partial Matches: Use partial strings or wildcards to catch variations and new attempts related to the same offender (e.g., blocking all emails from *@frauddomain.com).
This flexibility is crucial because fraudsters often try to bypass restrictions by making small changes to their details.
Blocking Checkout Before Order Completion
One of Aelia Blacklister’s standout features is its ability to block malicious users early in the checkout process, before an order is even placed. This means:
Fraudulent users are prevented from completing transactions, saving you the hassle of processing fake orders or dealing with chargebacks.
It reduces server load and resource waste since fraudulent requests don’t reach your payment gateway or fulfillment process.
By intercepting offenders before they finish their orders, you minimise damage and improve store efficiency.
How to Set Up Aelia Blacklister for WooCommerce: Step-by-Step Guide
Step 1: Install and Activate the Plugin
Download the Aelia Blacklister plugin from the official Aelia website or your WooCommerce marketplace.
Log in to your WordPress admin dashboard.
Navigate to Plugins > Add New > Upload Plugin.
Upload the plugin ZIP file and click Install Now.
Once installed, click Activate to enable the plugin.
Step 2: Access Aelia Blacklister Settings
Go to WooCommerce > Settings > Aelia Blacklister or find the plugin’s menu in the dashboard.
Here you’ll see options to configure blocking rules based on user data.
Step 3: Set Up Blacklist Rules
Block by Name: Enter specific names (first, last, or full) that you want to blacklist. You can add multiple names and specify whether to block exact or partial matches.
Block by Email: Add individual email addresses or entire domains (e.g., *@frauddomain.com) to prevent orders from these sources.
Block by Phone Number: Input phone numbers or area codes associated with fraudsters.
Block by IP Address: Enter single IPs or use wildcards to block ranges of IP addresses.
Step 4: Configure Blocking Behavior
Decide at which stage users should be blocked, such as immediately when they enter checkout details or before order completion.
Enable notifications or logging features if you want to keep track of blocked attempts.
Step 5: Save Settings and Test
Click Save Changes to apply your blacklist rules.
Test by attempting to place an order with blacklisted details to ensure that blocking works as expected.
Step 6: Monitor and Update Regularly
Regularly review logs or reports to identify new suspicious patterns.
Update your blacklist with new names, emails, phones, or IPs as needed to stay ahead of fraudsters.
For WooCommerce store owners looking to enhance their overall store management beyond fraud prevention, Aelia also offers other useful plugins like Tax Display by Country for WooCommerce, which helps show accurate tax rates based on your customer’s location. Combining such plugins with fraud prevention tools like Aelia Blacklister can create a more secure and compliant online shopping experience.
Best WooCommerce Plugins to Prevent Fraud and Block Malicious Users
/in BlogWithout proper security, managing a WooCommerce store becomes a losing battle. Manually screening every customer for fraud is like trying to carry water in your hands—most of it slips right through. The effort feels almost pointless.
This naturally leads to the question: Is WooCommerce safe?
If you run a WooCommerce store, you already know the answer isn’t simple. Fake orders are an ongoing headache. You’re stuck reviewing emails, addresses, phone numbers, and order details to figure out which transactions are legitimate. It’s time-consuming, exhausting, and far from scalable. But skipping this step is risky — it could cost you far more than just time.
Letting a fraudulent order slip through can set off a chain reaction. First, you lose inventory. Then your customer service team gets overwhelmed handling disputes. Worst of all? The financial fallout. You may not get paid for the order and could face chargebacks or penalties from your payment processor. In some cases, not having sufficient security measures could even result in fines. Simply put, the cost of inaction is steep.
The good news? You don’t have to do it manually anymore.
For instance, you can block suspicious activity by IP address using tools that walk you through step‑by‑step how to identify and blacklist problematic IPs: How to Block Users by IP Address in WooCommerce.
In this article, we’ll take a closer look at the best plugins built specifically to combat fraud in WooCommerce. We’ll explore its features, ease of use, pricing, and overall value to help you choose the right one for your store.
Best Plugin To Prevent Fraud and Block Malicious Users in WooCommerce
The Aelia Blacklister plugin offers a powerful way to configure rules that block orders from specific users in WooCommerce. It helps protect your store by filtering out malicious customers based on various criteria, including:
Name and Surname
Address (Street, postcode, city, province/state, country)
Email Address
Phone Number
IP Address
How to Set Up Aelia Blacklister for WooCommerce
Setting up the Aelia Blacklister plugin is straightforward, even for users with limited technical knowledge. Follow these steps to enhance your store’s security by blocking fraudulent customers:
Step 1: Install the Aelia Blacklister Plugin
Part 1: Download the Plugin
Visit the official Aelia website to download the latest, most reliable version.
If the plugin requires purchase, complete the payment process.
Download the plugin ZIP file to your computer.
Part 2: Upload the Plugin to WordPress
Log in to your WordPress Admin Dashboard.
Navigate to Plugins > Add New.
Click on Upload Plugin at the top of the page.
Choose the downloaded ZIP file and click Install Now.
Part 3: Activate the Plugin
Wait for installation to complete; a success message will appear.
Click Activate to enable the plugin.
Once activated, you’ll find Aelia Blacklister listed under active plugins and available in WooCommerce settings.
Blocking Options in Aelia Blacklister
1. Block by User Name
Prevent orders from specific users by blocking their names (first name, last name, or full name). This is useful for stopping known fraudsters who use consistent identity details.
Enter the full name or parts of the name in the User Name section.
You can block exact matches or partial names to catch variations.
Click Save to apply the block.
2. Block by Address
Block orders based on specific address details such as street, postcode, city, province/state, or country. This helps stop fraudsters using fake or stolen addresses.
Enter full or partial address details in the Address section.
Choose the blocking criteria (street, postal code, region).
Click Save to apply.
3. Block by Email Address
Block individual email addresses or entire domains to prevent fraudulent sign-ups or orders.
Input the email or domain (e.g., *@disposablemail.com) in the Email Address field.
Save changes to enforce the block.
4. Block by Phone Number
Block specific phone numbers or entire area codes often associated with fraudulent activity.
Enter phone numbers or area codes in the Phone Number section.
Save to activate the block.
5. Block by IP Address
Block single IPs or IP ranges to prevent repeated fraud from the same network. You can use wildcards or regex for advanced patterns.
Enter IP addresses or ranges in the IP Address section.
Save the settings.
Final Step: Save and Apply Changes
After configuring your blocks, make sure to save all settings. Regularly update your blacklist to keep up with new fraudulent attempts and maintain your store’s security.
Why Use Aelia Blacklister for WooCommerce Compared to Other Plugins?
Comprehensive Blocking Options
Aelia Blacklister allows you to block orders based on multiple user details — including name, address, email, phone number, and IP address — offering more granular control than many other plugins that focus on only one or two criteria.
User-Friendly Setup
The plugin is designed for ease of use, allowing store owners with limited technical skills to configure powerful security rules without complicated setups or coding.
Flexible and Advanced Filtering
Supports partial matches, wildcards, and even regex for IP addresses, enabling highly customizable and effective blocking rules that can adapt to complex fraud patterns.
Seamless WooCommerce Integration
Aelia Blacklister integrates smoothly into the WooCommerce environment, with settings accessible directly through the WooCommerce dashboard for convenience and consistency.
Regular Updates and Reliable Support
Developed and maintained by a trusted team, the plugin receives updates to stay compatible with WooCommerce and WordPress, along with responsive customer support to help you troubleshoot.
Protects Against Multiple Types of Fraud
By blocking based on various user data points, it helps prevent common fraudulent behaviors like using fake addresses, disposable emails, stolen phone numbers, or repeated IP abuse.
Scalable for Growing Stores
Whether your store is small or rapidly growing, Aelia Blacklister scales with you, helping maintain security as order volume and customer base increase.
Securing your WooCommerce store is no longer optional—it’s a necessity. With the increasing threats of fraud, spam orders, and data breaches, having a tool like Aelia Blacklister empowers you to proactively safeguard your business. Its advanced filtering capabilities, simple setup, and seamless integration with WooCommerce make it one of the top security plugins available today.
To enhance conversions and elevate the overall shopping experience, consider pairing Aelia Blacklister with another powerful solution from the same developer: the Aelia Currency Switcher for WooCommerce. This plugin enables your store to display prices and accept payments in multiple currencies, making it easier to serve a global audience, all while maintaining tight control over fraud risks.
Why You Need a Security Plugin to Block Fraudulent WooCommerce Users
/in BlogWooCommerce has become a cornerstone of global eCommerce, powering millions of online stores across industries. Its flexibility, affordability, and ease of use make it a go-to solution for businesses of all sizes looking to sell online. As more merchants flock to WooCommerce, so do fraudsters. Fake accounts, fraudulent transactions, chargeback scams, and spam orders are on the rise, costing businesses time, money, and customer trust. To protect your store, it’s essential to block fraudulent WooCommerce users proactively. What’s worse, many of these attacks go unnoticed until the damage is already done.
In today’s environment, proactive fraud prevention isn’t optional — it’s essential. Relying on manual vetting or generic security plugins is no longer enough to stay ahead of evolving threats.
That’s where purpose-built tools like Aelia Blacklister for WooCommerce come in. Designed specifically for WooCommerce, Aelia Blacklister helps store owners block known bad actors before they can cause harm, whether by email, IP address, geographic location, or other criteria.
In this article, we’ll explore why a security plugin like Aelia Blacklister is crucial for any WooCommerce store and how it can help you stay one step ahead of fraudulent users.
Understanding Fraud in WooCommerce
Running a WooCommerce store isn’t just about selling products — it’s also about managing risk. As your store grows, so does your exposure to fraud. Understanding the different forms this can take is the first step to protecting your business.
Common Types of Fraudulent Activity:
Fake Orders
Orders placed with bogus customer details, often just to test stolen credit cards or overwhelm your operations.
Stolen Credit Card Use
Fraudsters use compromised payment information, which often leads to chargebacks and financial penalties for the merchant.
Spam Accounts
Automated bots or malicious users register accounts en masse to clog up your system or exploit discounts and promotions. Learn how email blacklisting helps stop spam accounts in WooCommerce.
Suspicious IP Activity
Repeated login attempts, geographic anomalies, or access from known proxy/VPN services often signal fraudulent behavior.
Refund Abuse
Users place legitimate orders only to claim fake issues and demand refunds, sometimes repeatedly.
Real-World Consequences:
Fraud isn’t just an annoyance — it has serious consequences:
Lost revenue from fraudulent or refunded transactions.
Chargeback fees and penalties from payment processors.
Inventory loss occurs when products are shipped before fraud is detected.
Damaged brand trust as legitimate customers lose confidence in your site’s security.
Why the Standard WooCommerce Setup Falls Short
While WooCommerce is a powerful platform, its out-of-the-box security features are fairly basic when it comes to fraud prevention.
Here’s Why That’s a Problem:
No Built-in Filtering for User Data
WooCommerce doesn’t offer native tools to block users by email domain, country, or IP address — common indicators of fraud.
Limited Blacklisting Capabilities
There’s no straightforward way to stop known bad actors from placing new orders or creating new accounts.
Reactive Rather Than Proactive
By default, WooCommerce puts the burden on store owners to monitor transactions and manually catch fraud after it’s occurred — a slow and error-prone process.
To truly protect your store, you need a solution that works before fraud happens, not after.
Introducing the Aelia Blacklister for WooCommerce
When it comes to fraud prevention, a proactive approach is key — and that’s exactly what Aelia Blacklister offers.
This powerful plugin is designed to block orders from suspicious or known-bad users before they can complete a transaction. With simple installation and an intuitive interface, Aelia Blacklister integrates seamlessly into any WooCommerce store, giving you granular control over who can place orders — and who can’t.
Whether you’re dealing with spam accounts, repeated refund abusers, or fraudulent IPs, Aelia Blacklister gives you the tools to fight back automatically.
Key Features of Aelia Blacklister
Aelia Blacklister stands out for its customisability and precision targeting. It allows you to configure flexible rules that automatically block users based on the following data:
Block Users By:
Customer Name or Surname
Email Address
Phone Number
Shipping Address
IP Address
Each of these fields can be used with exact matches or partial matches using regular expressions, giving you advanced control over how strict or broad your blacklist should be.
Custom Error Messaging
If a user is blocked at checkout, the plugin can show a customisable message explaining why their transaction was rejected, keeping your communication clear and professional.
Easy Backend Management
The plugin adds a dedicated menu to your WooCommerce admin area where you can:
Create and manage blacklist rules.
Add or remove specific entries.
Test and preview matching behavior.
Aelia Blacklister is built for store owners who need powerful tools without a steep learning curve. Whether you’re tech-savvy or just starting, its interface is approachable, and the rule configuration is straightforward.
How to Install the Aelia Blacklister Plugin for WooCommerce
Installing the Aelia Blacklister plugin is a quick and straightforward process that adds powerful fraud prevention tools to your WooCommerce store. Whether you’re looking to block suspicious users by IP, email, or even billing details, this plugin gives you full control from right inside your WordPress dashboard. Follow the steps below to get started.
Step 1: Purchase and Download the Plugin
Visit the official Aelia website: Aelia For WooCommerce
Purchase the Blacklister for WooCommerce plugin.
Once the purchase is complete, download the plugin
.zipfile to your computer.Step 2: Install the Plugin on Your WordPress Site
Log in to your WordPress admin dashboard.
Navigate to Plugins > Add New.
Click the “Upload Plugin” button at the top.
Select the
.zipfile you downloaded.Click Install Now, then Activate Plugin after installation completes.
Step 3: Access the Blacklister Settings
In your WordPress dashboard, go to WooCommerce > Blacklister.
This opens the plugin’s configuration panel, where you can start setting up your blacklist rules.
Step 4: Create Blacklist Rules by Customer Name or Surname
How to Block:
Within the Blacklister settings, find the Customer Name/Surname section. Here, you can enter full names or parts of names to block suspicious or fraudulent users.
Why It’s Important:
Fraudsters often reuse fake or stolen identities. Blocking names helps prevent repeat offenders from placing orders on your store.
Steps to Block:
Enter the exact names or use partial matches with regular expressions (e.g., block all names starting with “John”).
Click Save Changes to apply the blacklist.
Step 5: Create Blacklist Rules by Email Address
How to Block:
Emails are a common way fraudsters sign up or place orders. In the Email Address section, add specific emails or entire domains to block unwanted users.
Why It’s Important:
Blocking disposable or suspicious email domains prevents fraudsters from creating multiple fake accounts.
Steps to Block:
Enter single email addresses (e.g., fraudster@example.com) or domain patterns with wildcards/regex (e.g.,
*@tempmail.com).Save your changes.
Step 6: Create Blacklist Rules by Phone Number
How to Block:
In the Phone Number section, list phone numbers or area codes to block fraudulent users who attempt purchases using stolen or fake phone numbers.
Why It’s Important:
Phone numbers linked to fraud can be prevented from completing transactions, adding an extra security layer.
Steps to Block:
Add individual numbers or use regex to block number patterns (e.g., all numbers starting with
+1234).Save your settings.
Step 7: Create Blacklist Rules by Address
How to Block:
Use the Address section to block suspicious addresses, including street, city, postal code, province/state, or country.
Why It’s Important:
Blocking addresses associated with fraudulent activity can reduce fake orders and chargebacks.
Steps to Block:
Enter full or partial addresses. You may use regex for flexible matching (e.g., block all P.O. Boxes with
.*P.O. Box.*).Save your changes.
Step 8: Create Blacklist Rules by IP Address
How to Block:
Block suspicious IP addresses or entire IP ranges using the IP Address section. This helps stop repeated fraud attempts from the same network.
Why It’s Important:
Fraudsters often use the same IPs or VPN ranges to mask their identity. Blocking these reduces multiple fraudulent attempts.
Steps to Block:
Enter exact IPs (e.g.,
192.168.1.10), masks (e.g.,192.168.1.*), or ranges (e.g.,192.168.0.1-192.168.0.255).Use regex for more advanced blocking if needed.
Save your settings.
Step 9: Customise the Checkout Error Message
You can personalise the message customers see if their order is blocked.
In the plugin settings, find the Messages section.
Enter your custom message (e.g., “Your order cannot be completed at this time. Please contact support.”).
Save changes.
Step 10: Test Your Blacklist Rules
After setting up your rules:
Try placing test orders with blocked details to confirm the plugin correctly stops fraudulent attempts.
Adjust rules as needed based on test results.
Enhance Your WooCommerce Store Further with Aelia Currency Switcher
Now that you’ve strengthened your store’s security with the Aelia Blacklister plugin, consider improving your customers’ shopping experience by offering multi-currency support. The Aelia Currency Switcher for WooCommerce allows your customers to view prices and pay in their preferred currency seamlessly.
This is especially useful for stores with international customers, reducing cart abandonment and boosting conversions by showing accurate prices in real time.
Learn more and get the plugin here: Currency Converter for WooCommerce