Complete Guide to Retrieving Customer Details from Orders in WooCommerce

Introduction

Retrieving customer details from orders is a common yet sometimes challenging task in WooCommerce development. Many developers encounter incomplete data when using the WC_Customer object, often due to misunderstandings about WooCommerce's data structure.

Problem Analysis

The original question presents a typical scenario: a developer attempts to use new WC_Customer($order_id) to obtain customer information, but returns empty address, postcode, and other fields. Through var_dump($customer), we can see that while the customer object exists, most address fields are empty strings.

This phenomenon occurs because the WC_Customer object primarily manages session data for the currently logged-in user, rather than extracting historical information directly from orders. When initializing a customer object with an order ID, the system may not correctly load the complete customer profile data.

Solution 1: Using WC_Order Object

The most direct and effective method is to obtain order-related customer information through the WC_Order object. WooCommerce stores all information provided by customers during checkout in order metadata.

// Get order object
$order = wc_get_order($order_id);

// Get customer ID
$customer_id = $order->get_customer_id();

// Get billing information
$billing_first_name = $order->get_billing_first_name();
$billing_last_name = $order->get_billing_last_name();
$billing_address_1 = $order->get_billing_address_1();
$billing_address_2 = $order->get_billing_address_2();
$billing_city = $order->get_billing_city();
$billing_postcode = $order->get_billing_postcode();
$billing_country = $order->get_billing_country();

// Get shipping information
$shipping_first_name = $order->get_shipping_first_name();
$shipping_last_name = $order->get_shipping_last_name();
$shipping_address_1 = $order->get_shipping_address_1();
$shipping_address_2 = $order->get_shipping_address_2();
$shipping_city = $order->get_shipping_city();
$shipping_postcode = $order->get_shipping_postcode();
$shipping_country = $order->get_shipping_country();

The main advantage of this approach is its ability to accurately retrieve the specific information provided by the customer at the time of ordering, unaffected by subsequent updates to the customer profile.

Solution 2: Direct User Meta Queries

When needing to obtain the latest information from a customer's account, you can directly query the WordPress user meta table. This is the most reliable method, unaffected by session state or object caching.

function get_customer_shipping_details($user_id) {
    $shipping_details = array();
    
    $shipping_details['first_name'] = get_user_meta($user_id, 'shipping_first_name', true);
    $shipping_details['last_name'] = get_user_meta($user_id, 'shipping_last_name', true);
    $shipping_details['company'] = get_user_meta($user_id, 'shipping_company', true);
    $shipping_details['address_1'] = get_user_meta($user_id, 'shipping_address_1', true);
    $shipping_details['address_2'] = get_user_meta($user_id, 'shipping_address_2', true);
    $shipping_details['city'] = get_user_meta($user_id, 'shipping_city', true);
    $shipping_details['state'] = get_user_meta($user_id, 'shipping_state', true);
    $shipping_details['postcode'] = get_user_meta($user_id, 'shipping_postcode', true);
    $shipping_details['country'] = get_user_meta($user_id, 'shipping_country', true);
    
    return $shipping_details;
}

// Usage example
$user_id = get_post_meta($order_id, '_customer_user', true);
$shipping_info = get_customer_shipping_details($user_id);

The advantage of this method lies in its stability and reliability, correctly returning data regardless of whether the user is logged in or in the admin interface.

Solution 3: Formatted Address Information

For scenarios requiring formatted address display, WooCommerce provides convenient methods:

$order = wc_get_order($order_id);

// Get formatted billing address
$billing_address_html = $order->get_formatted_billing_address();

// Get formatted shipping address
$shipping_address_html = $order->get_formatted_shipping_address();

// Directly get address strings
$billing_address = $order->get_billing_address();
$shipping_address = $order->get_shipping_address();

These methods automatically handle address formatting and localization, ensuring address display conforms to target region conventions.

Data Source Comparison Analysis

Understanding the differences between various data sources is crucial for selecting the correct method:

• Order Data: Reflects specific information provided by the customer at order time, with historical accuracy
• Customer Profile Data: Reflects the latest information in the customer account, which may have been updated
• Session Data: Only valid for currently logged-in users, limited by session state

Best Practice Recommendations

Based on practical development experience, we recommend following these best practices:

1. For order-related customer information, prioritize methods using the WC_Order object
2. When needing the latest customer profile information, use direct user meta query methods
3. Avoid relying on WC_Customer object session data in non-frontend environments
4. Always perform null checks and data validation when handling critical business logic

Application Scenario Extensions

These techniques are not only applicable to simple data retrieval but can also extend to more complex application scenarios:

• Personalized content generation for order confirmation emails
• Customer behavior analysis and segmentation
• Third-party system integration and data synchronization
• Custom reporting and data analysis

Conclusion

When retrieving customer details from orders in WooCommerce, choosing the correct method is crucial. By understanding the characteristics and limitations of different data sources, developers can avoid common data retrieval issues and ensure application stability and accuracy. Directly using WC_Order object methods and querying user metadata are the most reliable technical solutions, suitable for most practical application scenarios.