In this document, you’ll learn about Customers and their relation to other entities in Medusa.
Customers are individuals that make purchases in your store. In Medusa, there are two types of customers: registered customers and guests or unregistered customers.
Both registered and unregistered customers can make purchases. However, only registered customers can log into their accounts and manage their details and orders.
An admin user can view and manage their customers, their details, their orders, and what customer group they’re in.
Customer Entity Overview
A customer is stored in the database as a
Customer entity. A customer has attributes related to the customer’s details such as
phone. However, the only required attribute is
As mentioned earlier, customers can be either registered or unregistered. The type of customer is identified in the
has_account attribute. This is a boolean attribute that indicates whether the customer is registered.
For example, when a guest customer places an order, a new
Customer record is created with the email used (if it doesn’t already exist) and the value for
false. When the unregistered customer creates an account using the same email, a new
Customer record will be created with the value of
has_account set to
An email is unique to a type of customer. So, an email can be associated with only one registered customer (where
true), and one unregistered customer (where
In the example mentioned above, after the unregistered customer places an order with an email, then creates an account with the same email, two
Customer records are created. Each of these records have different
This architecture allows creating the Claim Order flow, where a registered customer can claim an order they placed as an unregistered customer. You can learn more about it in this documentation.
Relations to Other Entities
Customer groups allow dividing customers into groups of similar attributes, then apply special pricing or rules for these customer groups.
A customer can belong to more than one customer group. The relation between the
CustomerGroup entities is available on both entities:
- You can access the customer groups of a customer by expanding the
groupsrelation and accessing
- You can access the customers in a customer group by expanding the
customersrelation and accessing
Customers can have more than one order. The relation between the
Order entities is available on both entities:
- You can access the orders of a customer by expanding the
ordersrelation and accessing
- You can access the customer that placed an order by expanding the
customerrelation and accessing
A customer can have a billing address and more than one shipping address. Both billing and shipping addresses are represented by the
The relation between the
Address entities is available on both entities:
- You can access the billing address of a customer by expanding the
billing_addressrelation and accessing
customer.billing_address. You can also access the shipping addresses of a customer by expanding the
shipping_addressesrelation and accessing
- Likewise, you can access the customer that an address is associated with by expanding the
customerrelation and accessing