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!

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(
		array(
			'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: Display & Save WP User Profile Field @ Checkout
  I’m curious to know how many had the same problem. On the WooCommerce Checkout page, some user fields such as billing_name, shipping_address_1, etc. are automatically saved into the “WordPress User Profile” data upon processing. But what if we also wanted to display and save another existing user field, such as “user_twitter“, or “user_url“, which you […]
• 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. […]

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