WooCommerce · Guide
How to Add WooCommerce Customer (Step by Step)

Short answer
Go to Users, then Add New User, enter a username and email, set the role to Customer and save. Then open the profile and fill in the billing and shipping address fields so checkout and manual orders use them.
Key takeaways
- WooCommerce customers are WordPress users with the Customer role.
- Add billing and shipping details on the user profile after creating it.
- Manual orders can use an existing customer or guest details.
- Bulk imports need a user import plugin and a CSV file.
- Developers can use the REST API or WP-CLI to create customers.
- New accounts may not appear in Customers analytics until they order.
How do you add a customer in WooCommerce?
You add a WooCommerce customer by creating a WordPress user with the Customer role under Users > Add New User, then filling in their billing and shipping details on their profile.
WooCommerce does not keep a separate customer database. Every registered customer is a normal WordPress user with the Customer role and some extra fields for addresses.
That means the steps feel familiar if you have ever added a user to WordPress. The only extra work is the store-specific data, such as the billing address, phone number and shipping address.
There are also other routes. You can create a customer while building a manual order, import many customers from a CSV file, or create them through the REST API or WP-CLI. Each method is covered below.
What do you need before adding a customer?
You need an administrator or shop manager account, WooCommerce installed and active, and the customer's name and email address at a minimum.
Check these points first:
- Your role. Administrators can create any user. Shop managers can usually create and edit customers, but your setup or a role plugin may change that. Our guide to WordPress user roles explains what each role can do.
- A unique email address. WordPress will not let two users share one email. If the customer already bought as a guest, their email is not yet tied to a user account, so you can still use it.
- Consent. Only create accounts for people who expect one. Sending account emails to people who never asked can break privacy rules and annoy customers.
If WooCommerce is not installed yet, start with our guide on installing WooCommerce manually.
How do you add a customer from the Users screen?
Go to Users > Add New User, enter a username and email, set the role to Customer, choose whether to send an account email, and click Add New User.
Here are the steps in order:
- Log in to your WordPress dashboard.
- Go to Users > Add New User. On older versions the menu item is called Add New.
- Enter a Username. Customers cannot change this later, so keep it simple, such as their first name and a number.
- Enter the customer's Email address.
- Add the First Name and Last Name if you have them.
- Leave the generated Password in place, or set your own.
- Tick Send User Notification if you want WordPress to email the customer a link to set their password.
- Set Role to Customer.
- Click Add New User.
The customer can now log in to the My Account page on your store. They will see their orders, downloads and saved addresses there.
The official WordPress user documentation explains every field on this screen if you need more detail.
How do you add billing and shipping details?
Open the new user under Users > All Users, scroll down to the customer address sections, fill in the billing and shipping fields, and click Update User.
When WooCommerce is active, each user profile gets two extra blocks: Customer billing address and Customer shipping address. These hold the details that pre-fill checkout and manual orders.
Fill in what you know:
- First and last name, and company if it applies
- Address lines, city, postcode and country
- State or county, where your country uses one
- Phone number and billing email
The billing email can be different from the login email. Some business customers want invoices sent to an accounts inbox, for example.
You can leave the shipping block empty if the customer only buys digital products. If shipping matches billing, there is a button to copy the billing address across.
Can you add a customer while creating an order?
Yes, you can attach an existing customer to a manual order in WooCommerce > Orders > Add order, and you can type in guest details for someone who has no account yet.
This route suits phone orders, invoices and wholesale buyers. The official WooCommerce guide to manual orders covers the full screen.
The basic flow is:
- Go to WooCommerce > Orders and click Add order.
- In the Customer field, search for the person by name or email.
- If they exist, select them. Click Load billing address and Load shipping address to pull their saved details.
- Add products, fees or shipping lines.
- Recalculate totals, set the order status and click Create.
If the person does not have an account, you can leave the customer field set to guest and fill in billing and shipping by hand. The order is saved, but no user account is created.
WooCommerce core does not create a new user from this screen. If you want that, first add the customer under Users, then come back to the order. Some plugins, such as Add Customer for WooCommerce, add a checkbox that creates the account for you when you save the order.
Our guide on WooCommerce payment settings helps if you need to collect payment for a manual order.
How do you import many customers at once?
To add many customers at once, export them to a CSV file and use a user import plugin that can set the Customer role and map billing and shipping columns.
WordPress core has no built-in CSV user importer. WooCommerce's built-in importer handles products, not customers. So bulk adding means a plugin or a custom script.
A typical plugin import looks like this:
- Prepare a CSV with columns for username, email, first name, last name and role.
- Add WooCommerce field columns such as billing_address_1, billing_city, billing_postcode, billing_country and billing_phone.
- Set the role column to customer for every row.
- Upload the file in the plugin and match the columns.
- Choose whether to send account emails, then run the import.
Run a test with three or four rows first. Check the imported profiles before you upload thousands of records.
Keep the import file safe and delete it when you are done. It holds personal data you do not want lying around on your computer or server.
How do you add customers with the REST API or WP-CLI?
Developers can create customers with a POST request to the WooCommerce REST API customers endpoint, or with the wp user create command and the customer role.
The REST API route is useful when another system, such as a CRM or a point of sale, needs to push customers into your store. The WooCommerce REST API docs show the full request format for creating a customer.
You need API keys with write access. Our guide on getting a WooCommerce API key walks through that step.
A minimal request body looks like this:
{
"email": "[email protected]",
"first_name": "Jane",
"last_name": "Doe",
"username": "jane.doe",
"billing": {
"first_name": "Jane",
"last_name": "Doe",
"address_1": "1 High Street",
"city": "Leeds",
"postcode": "LS1 1AA",
"country": "GB",
"email": "[email protected]",
"phone": "01130000000"
}
}
If you manage the server by command line, WP-CLI is faster for one-off jobs. The wp user create command accepts a role:
wp user create jane.doe [email protected] --role=customer --first_name=Jane --last_name=Doe
That creates the account. Billing and shipping details can then be added on the profile screen or with user meta commands.
Which method should you use?
Use the Users screen for one or two customers, the order screen for phone orders, a plugin for bulk imports, and the API or WP-CLI for automated or repeated jobs.
| Method | Best for | Creates account | Adds addresses |
|---|---|---|---|
| Users > Add New User | One customer at a time | Yes | Yes, on the profile |
| Manual order (guest) | Phone or invoice orders | No | On the order only |
| Manual order plus plugin | Phone orders that need accounts | Yes | Yes |
| CSV import plugin | Moving from another shop | Yes | Yes, if columns are mapped |
| REST API | Syncing from a CRM or POS | Yes | Yes |
| WP-CLI | Server admins and scripts | Yes | With extra commands |
Most small stores only ever need the first two methods. The others matter when you migrate a shop or connect outside tools.
Should customers create their own accounts instead?
Often, yes, because letting shoppers register at checkout or on My Account means they choose their own password and give consent to an account.
You control this under WooCommerce > Settings > Accounts & Privacy. You can allow account creation during checkout, on the My Account page, or both. You can also allow guest checkout so nobody is forced to register.
Our guide on creating a WooCommerce account covers these settings and how they affect checkout.
Adding customers by hand still makes sense for:
- Wholesale or trade customers you set up before their first order
- Customers you are moving from another platform
- Staff purchases or test accounts
- People who order by phone and want to track orders online later
Why does a new customer not show in WooCommerce > Customers?
A new customer often does not appear in WooCommerce > Customers until they place an order or the analytics data refreshes, even though the user account exists.
The Customers screen is part of WooCommerce Analytics. It builds its list from order data and a lookup table, so a fresh account with no orders may be missing or appear later.
Try these checks:
- Confirm the account exists under Users > All Users with the Customer role.
- Wait a few minutes, as analytics data is processed in the background by the Action Scheduler.
- Check WooCommerce > Status > Scheduled Actions for failed or pending jobs.
- Look under Analytics > Settings for options to import or rebuild historical data.
If the user exists under Users, the customer can log in and buy. The missing row is a reporting delay, not a broken account.
What mistakes should you avoid?
Avoid using the wrong role, reusing email addresses, skipping the billing country, and sending account emails to people who did not ask for an account.
Common slip-ups include:
- Choosing Subscriber instead of Customer. The account works, but some plugins and reports filter by the Customer role.
- Leaving out the country. Tax and shipping rules depend on it, so manual orders may calculate wrong totals.
- Typing a fake email. Order emails and password resets go nowhere, and WooCommerce may reject the account later.
- Creating duplicate accounts. Search Users by email before you add someone, especially after a migration.
- Ignoring privacy rules. Keep only the data you need and tell customers how you use it. This is general information, not legal advice, so check the rules that apply where you trade.
Once the customer is set up, they can log in, see their order history and reorder in a few clicks.
Frequently asked questions
Is a WooCommerce customer the same as a WordPress user?
Yes. WooCommerce stores registered customers as WordPress users with the Customer role. Their billing and shipping details are saved as extra fields on the user profile, so you manage them from the Users screen like any other account.
Can a shop manager add customers?
Usually, yes. The Shop Manager role created by WooCommerce can create and edit customers by default. If your site uses a role editor or membership plugin, it may change those permissions, so check the role settings if the option is missing.
Does a guest order create a customer account?
No. A guest order stores the name, email and address on the order only. If the shopper later registers with the same email, some setups can link past orders, but core WooCommerce does not create an account from a guest order by itself.
Will the customer get an email when I add them?
Only if you tick the option to send the user a notification when creating the account. That email contains a link to set a password. If you leave it unticked, the customer will need to use the lost password link on your store.
How do I delete a WooCommerce customer?
Go to Users, hover over the customer and click Delete. WordPress asks what to do with any content they own. Their past orders stay in WooCommerce, but think about your data retention rules before removing records.
Sources
- Users Add New Screen WordPress.org Documentation
- Single Order Page and Manually Adding an Order WooCommerce
- WooCommerce REST API: Create a customer WooCommerce
- wp user create WordPress Developer Resources
- Add Customer for WooCommerce WordPress.org Plugins
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


