WooCommerce: Get List Of All Customers

Today’s snippet is a helpful shortcut for getting the list of customers in your WooCommerce website. This may be necessary during customization, especially if you need tailor-made features for administrators and shop managers in the backend or frontend.

How did I find out about the solution below? Well, our job is mainly copy/paste from online forums or read thoroughly the WooCommerce core files on a daily basis – so it must’ve been one of the two. Enjoy!

This is the backend area for WordPress users = “customers”. You will be able to get this exact list with the code below in case you need it elsewhere e.g. a dropdown for the admin, a custom report for store managers, and so on.

PHP Function: Get List of All WooCommerce “Customers”

 * @snippet       Get Array Of WooCommerce Customers
 * @how-to        Get CustomizeWoo.com FREE
 * @author        Rodolfo Melogli
 * @compatible    WooCommerce 6
 * @community     https://businessbloomer.com/club/

function bbloomer_customer_list() {
	$customer_query = new WP_User_Query(
			'fields' => 'ID',
			'role' => 'customer',			
	return $customer_query->get_results();

Usage: call the bbloomer_customer_list() function and then loop over the returned array to go through each customer and get whatever you need:

foreach ( bbloomer_customer_list() as $customer_id ) {
	$customer = new WC_Customer( $customer_id );
	echo $customer->get_billing_first_name() . ' ' . $customer->get_billing_last_name();

Where to add custom code?

You should place custom PHP in functions.php and custom CSS in style.css of your child theme: where to place WooCommerce customization?

This code still works, unless you report otherwise. To exclude conflicts, temporarily switch to the Storefront theme, disable all plugins except WooCommerce, and test the snippet again: WooCommerce troubleshooting 101

Related content

  • WooCommerce: Add Column to “Users” Admin Table
    On the admin side, you might need to display WooCommerce information inside the users table (WordPress Dashboard > Users). For example, their billing country. Or their phone number. Or maybe some custom calculation e.g. the number of completed orders. Either way, this is super easy. First, we add a new column – second, we tell […]
  • WooCommerce: Check if User Has Bought Product in the Last 365 Days
    A few snippets ago we introduced the magic WooCommerce inbuilt function “wc_customer_bought_product” – automatically, with a single line of PHP, you can find out if the user has already purchased a product ID. But when building my new #BloomerArmada section, I had to know if a user purchased a product ID in the last 365 […]
  • WooCommerce: Update User Meta After a Successful Order
    When an order is placed in WooCommerce, you might want to change/add something in the User Meta programmatically. For example, you could “check” a custom checkbox in the User Profile. Or maybe assign the User Twitter username. And so on ๐Ÿ™‚
  • WooCommerce: Get Current User Orders By Status
    This is a neat custom function that you can use in your WooCommerce customization. It can be helpful to know the list of orders placed by the current user ID, for example, if they are in their “My Account” page and you have a custom tab where you want to show e.g. only failed orders. […]
  • WooCommerce: Change Address Format For a Specific Country
    We’ve already covered a little about address formats when we added a custom House Number field to the WooCommerce Checkout page. Address formats define the way Billing and Shipping addresses are formatted for the end user. Addresses show on the order received / thank you page, on transactional emails and on some My Account pages, […]

Rodolfo Melogli

Business Bloomer Founder

Author, WooCommerce expert and WordCamp speaker, Rodolfo has worked as an independent WooCommerce freelancer since 2011. His goal is to help entrepreneurs and developers overcome their WooCommerce nightmares. Rodolfo loves travelling, chasing tennis & soccer balls and, of course, wood fired oven pizza. Follow @rmelogli

6 thoughts on “WooCommerce: Get List Of All Customers

  1. Thanks for sharing. But in my opinion, to have a list of customers in woocommerce, the above code is not completely accurate. Because you only get users with the ‘customer’ role. There are other customers whose roles are not ‘customer’.

    1. You can alternatively use the “role__in” parameter, which accepts an array of role names: https://developer.wordpress.org/reference/classes/wp_user_query/#user-role-parameter

  2. Many Thanks For the useful content but, i’m facing the issue (Fatal error: Uncaught Error: Class “WC_Customer” not found) when used the below code together

    1. Hi Roopam you can’t really do that, the second part of the snippet must be wrapped into its own function first.

  3. Hi I love you code and always use it, I have been for years. Would you know a way of adding a custom checkout filed that displays a list of all the existing customers and the user been able to select them in the form, I know you have two separate tutorials on this but I could not get it to work together. Thanks

    1. Hi Darren, thanks so much for your comment! Yes, this is definitely possible, but I’m afraid it’s custom work. If you’d like to get a quote, feel free to contact me here. Thanks a lot for your understanding!

Questions? Feedback? Customization? Leave your comment now!

If you are writing code, please wrap it like so: [php]code_here[/php]. Failure to complying with this, as well as going off topic or not using the English language will result in comment disapproval. You should expect a reply in about 2 weeks - this is a popular blog but I need to get paid work done first. Please consider joining the Business Bloomer Club to get quick WooCommerce support. Thank you!

Your email address will not be published. Required fields are marked *