---
title: "Customers"
description: "The Customers page displays all store customers who have placed orders or created accounts."
url: "https://docs.j2commerce.com/v6/sales/customers"
markdown_url: "https://docs.j2commerce.com/v6/sales/customers.md"
last_updated: "2026-10-23T02:33:38+00:00"
version: "J2Commerce 6"
breadcrumbs:
  - title: "Home"
    url: "https://docs.j2commerce.com/"
  - title: "J2Commerce 6"
    url: "https://docs.j2commerce.com/v6"
  - title: "Sales"
    url: "https://docs.j2commerce.com/v6/sales"
  - title: "Customers"
    url: "https://docs.j2commerce.com/v6/sales/customers"
---

# Customers

The Customers page displays all store customers who have placed orders or created accounts. View customer contact information, order history, and total spending.

## Requirements

- PHP 8.3.0+
- Joomla 6.x
- J2Commerce 6.x

## Locating Customers

Customers are managed from the J2Commerce Dashboard.

There are **two** ways you can access the customers.

**Option A:** Go to the **J2Commerce** icon at the top right corner **-> Sales -> Customers**

**Option B:** Go to **Components** on the left sidebar **-> J2Commerce -> Dashboard -> Sales -> Customers**

![Joomla admin navigation to Customers: Components, J2Commerce, Dashboard, then the J2Commerce menu button with Sales and Customers highlighted, above the Customers list](https://docs.j2commerce.com/images/docs/shared/customers.webp)

## Customers List View

![Customers list view with the table header highlighted: Customer Name, Email, Address, City, Country, Zone, Telephone, Orders, ID (customer data blurred)](https://docs.j2commerce.com/images/docs/shared/customers-title.webp)

The customers list displays customer information aggregated from orders and addresses:

**Name:** Customer full name (first name + last name)

**Email:** Customer email address

**Address:** Customer address

**City:** Customer city

**Country:** Customer country

**Zone:** Customer Zone

**Telephone:** Primary phone number

**Orders:** The number of orders the customer has had

### Customer Information Source

J2Commerce builds the customer list from:

- Order billing addresses
- Order shipping addresses
- Registered Joomla user accounts

Customers are grouped by email address — if the same email appears in multiple orders, they are shown as a single customer entry.

### Filter Options

**Search:** Search by name, email, company, or city

**Country:** Filter customers by country

![Customers list with search box, Filter Options and Select Country dropdown highlighted, plus sort arrows on Customer Name, Email, City, Country and Zone column headers](https://docs.j2commerce.com/images/docs/shared/customers-search1.webp)

## Customer Detail View

Click on a customer's name to view their details:

### Customer Details Tab

![Edit Customer, Customer Details tab highlighted: First Name, Last Name, Email and Company fields (values hidden), with the linked User field at right](https://docs.j2commerce.com/images/docs/shared/customers-config.webp)

**First Name:** Customer first name

**Last Name:** Customer last name

**Email:** Customer email address

**Company:** Company name (if applicable)

### Address Information Tab

![Edit Customer, Address Information tab highlighted: Address Line 1 and 2, City, ZIP Code, Country United States, Zone, telephones, Address Type Billing, and Tax Number](https://docs.j2commerce.com/images/docs/shared/customers-config-1.webp)

**Phone 1:** Primary phone number

**Phone 2:** Secondary phone number

**Address Line 1:** Street address

**Address Line 2:** Additional address info

**City:** City/town

**Postcode:** Postal/ZIP code

**Country:** Country

**Zone/State:** State/province

### Search for a Customer

1. Use the **Search** field in the filter bar.
2. Enter a name, email, company name, or city.

![Customers list with the Search Customers box and search button highlighted (search text blurred), above the customer table with an order count badge (customer data blurred)](https://docs.j2commerce.com/images/docs/shared/customers-search.webp)

### Filter by Country

- Click the **Country** dropdown.
- Select one or more countries.
- The list updates automatically.

![Customers list with Filter Options expanded and the Select Country dropdown highlighted, above the customer table (customer data blurred)](https://docs.j2commerce.com/images/docs/shared/customers-filter.webp)

- Or you can organize them in alphabetical order

![Customers list with the Country column's sort arrows highlighted next to City, Zone, Telephone and Orders, sorted by Customer Name Ascending (customer data blurred)](https://docs.j2commerce.com/images/docs/shared/customers-country.webp)

## Understanding Customer Data

### Guest vs Registered Customers

| Type | Data Source | Features |
| --- | --- | --- |
| **Guest** | Order billing address | Limited to order information |
| **Registered** | Joomla user + orders | Full profile, order history, address book |

### Customer Addresses

Customers can have multiple addresses:

- **Billing address** — Where invoices are sent
- **Shipping address** — Where orders are delivered

These may differ for each order. The customer list shows the most recent address.

![Edit Customer, Address Information tab, with the Address Type dropdown set to Billing highlighted, beside the Tax Information Tax Number field](https://docs.j2commerce.com/images/docs/shared/customers-config-address.webp)

## Tips

- **Search by email** for the most accurate customer matching
- **Filter by country** to find regional customer bases for targeted marketing

## Troubleshooting

### Customer Appears Multiple Times

**Cause:** Different email addresses used for different orders.

**Solution:**

1. This is expected behavior — each unique email creates a separate customer entry.
2. Customers may check out with different email addresses.
3. If you need to merge customer records, use a third-party CRM extension.

### Customer Not Found in List

**Cause:** No orders placed yet, or search filters are too restrictive.

**Solution:**

1. Clear all filters using the **Reset** button.
2. Remember that the Customers list only shows customers who have placed orders.
3. For customers who registered but haven't ordered, check **Users** in Joomla's admin.

### Wrong Customer Information Shown

**Cause:** Multiple addresses exist for the customer.

**Solution:**

1. Open the customer's order history.
2. The customer list shows the most recently used address.
3. Check individual orders to see addresses used for each purchase.

### Cannot Edit Customer Details

**Cause:** Customer data is derived from orders, not a standalone customer record.

**Solution:**

1. For registered customers: Edit the Joomla user in **Users** → **Manage**.
2. For guest customers: Information is stored per-order and cannot be changed centrally.
3. Address changes should be made during checkout or in the customer's account area on the frontend.