Customer data, segments and accounts: the parts, in plain words

35 parts and 15 phrases. Apps in this area include Shopify Customers, Klaviyo profiles, Segment, Bonify Customer Account Fields.

Customer accountcustomer.accountShowHow a customer signs in and the pages they see once signed in.

Signing incustomer.account.loginShowThe ways a customer proves who they are.

How to extend

ProviderMany side by sidesign-in providerEach social sign-in is a separate provider beside the email link.

Part	Litestore today	How to extend
Email sign-in link`customer.account.login.email_link`An email sign-in link is a one-time link sent to the customer's address that signs them in without a password.	Core`platform/auth/server.ts`	Provider · many
Sign in with an outside account`customer.account.login.external_account`Outside-account sign-in checks the customer's identity through another account they hold, such as Google.	Core`platform/auth/server.ts`	Provider · many
Password`customer.account.login.password`Password sign-in checks an email and a password the customer chose.	Plugin	Provider · many
Order without an account`customer.account.login.no_account`An order without an account is placed by a shopper who never signs in, from a cart tied to the browser session.	Core`modules/checkout/resolve-cart.ts`	Provider · many
Account invitation`customer.account.login.invitation`An account invitation emails a customer a link to activate an account staff created for them.	Core`modules/customers/invitations.ts`	Provider · many

Account pagescustomer.account.pageShowWhat a signed-in customer sees.

How to extend

SlotMany side by sideaccount.slot.orders.list account.slot.order_status.mainA plugin adds a panel to the order list or an order's status page.

Part	Litestore today	How to extend
Order history`customer.account.page.orders`The order history page lists the customer's orders with their status and totals.	Core`app/(web)/dashboard/orders/page.tsx`	Slot · many
Order detail`customer.account.page.order_detail`The order detail page shows one order's items, payment, shipping and tracking.	Core`app/(web)/dashboard/orders/[id]/page.tsx`	Slot · many
Profile settings`customer.account.page.profile`The profile settings page edits the customer's name and phone number.	Core`modules/customers/storefront/dashboard/settings/account-profile.tsx`	Slot · many
Saved addresses`customer.account.page.addresses`The saved addresses page adds, edits and removes addresses and sets the default.	Core`modules/customers/storefront/dashboard/settings/address-list.tsx`	Slot · many
Wishlist`customer.account.page.wishlist`The wishlist page shows the products the customer saved for later.	Core`app/(web)/wishlist/page.tsx`	Slot · many
Messages`customer.account.page.messages`The messages page holds the customer's conversation with the store and order updates.	Core`app/(web)/messages/page.tsx`	Slot · many
My coupons`customer.account.page.coupons`The coupons page lists the discount codes the customer has received.	Core`app/(web)/dashboard/coupons/page.tsx`	Slot · many

Customer recordcustomer.profileShowThe fields stored on each customer.

How to extend

EventMany side by sideevent.customer.created event.customer.updatedA plugin that copies customers to another system listens for these events.
SlotMany side by sideadmin.slot.customer.blockA plugin shows its own data about a customer in the admin customer page sidebar.

Part	Litestore today	How to extend
Name, email and phone`customer.profile.contact`The contact fields hold the customer's name, a unique email address and a phone number.	Core`prisma/schema.prisma`	Event · manySlot · many
Address book`customer.profile.address_book`The address book holds a customer's saved addresses with one default, and each order keeps its own copy of the address used.	Core`modules/customers/addresses`	Event · manySlot · many
Marketing consent`customer.profile.marketing_consent`The marketing consent fields record when the customer agreed to marketing email and when they unsubscribed.	Core`modules/customers/admin/customer-detail.tsx`	Event · manySlot · many
Staff note`customer.profile.staff_note`A staff note is internal text about the customer that only store staff see.	Core`modules/customers/admin/actions.ts`	Event · manySlot · many
Customer tag`customer.profile.tag`A customer tag is a short label, such as wholesale or trade, that staff or apps add to group customers.	Plugin	Event · manySlot · many
Custom field`customer.profile.custom_field`A custom field stores an extra typed value on the customer, such as a birthday or company number.	Plugin	Event · manySlot · many

Order numberscustomer.metricShowFigures calculated from a customer's orders.

How to extend

Assistant toolgetCustomerSummarygetCustomerInfoThe assistant reads a customer's spend, orders and stage through these tools.
Core onlySpend and order counts come from the order ledger, which stays in core.

Part	Litestore today	How to extend
Total spent`customer.metric.total_spent`Total spent is the sum of the customer's paid orders to date, the historic lifetime value.	Core`prisma/schema.prisma`	Assistant toolCore only
Order count`customer.metric.order_count`The order count is the number of orders the customer has placed.	Core`prisma/schema.prisma`	Assistant toolCore only
Last order date`customer.metric.last_order_date`The last order date records when the customer last bought.	Core`prisma/schema.prisma`	Assistant toolCore only
Predicted lifetime value`customer.metric.predicted_value`Predicted lifetime value is an estimate of what a customer will spend in a coming period, calculated from past buyers' order patterns.	Plugin	Assistant toolCore only
Recency, frequency and spend score`customer.metric.recency_frequency_spend`A recency, frequency and spend score grades each customer on how recently, how often and how much they bought.	Plugin	Assistant toolCore only

Stagecustomer.lifecycleShowWhere a customer stands, calculated from their account, orders and moderation.

How to extend

Core onlyThe stage is calculated in one place from account, order and ban facts so every surface reads the same answer.

Part	Litestore today	How to extend
Lifecycle stage`customer.lifecycle.stage`The lifecycle stage is calculated as new, invited, registered, purchased or repeat from the customer's account, invitations and order count.	Core`modules/customers/lifecycle.ts`	Core only
Buyer with no recent order`customer.lifecycle.inactive`A buyer with no recent order is a past customer with no order within a set number of days, which Litestore uses to pick win-back recipients.	Core`jobs/cron.index-data.ts`	Core only
Restricted or banned`customer.lifecycle.trust_level`The trust level marks an account active, restricted or banned, with an optional ban end date, and cart and checkout actions check it.	Core`modules/customers/stage.ts`	Core only

Segmentscustomer.segmentShowGroups of customers selected by rules.

How to extend

Assistant toolcountBroadcastAudienceThe assistant counts a lifecycle segment before proposing a send to it.

Part	Litestore today	How to extend
Segment by stage`customer.segment.by_stage`A stage segment selects reachable customers in chosen lifecycle stages and leaves out unsubscribed, restricted and banned ones.	Core`modules/email/broadcast-audience.ts`	Assistant tool
Segment by rule`customer.segment.by_rule`A rule segment selects customers by filters on fields and behaviour, such as amount spent, location or products bought.	Plugin	Assistant tool
Segment by tag`customer.segment.by_tag`A tag segment selects the customers that carry a given tag.	Plugin	Assistant tool
Segment by recency, frequency and spend`customer.segment.by_recency_frequency_spend`This segment selects customers by their recency, frequency and spend group, such as frequent high spenders or past buyers slipping away.	Plugin	Assistant tool

Managing customerscustomer.adminShowWhat staff do with customer records in the admin.

How to extend

ProviderMany side by sidecustomer importerEach import source, such as a CSV file or a Shopify store, is a separate importer.

Part	Litestore today	How to extend
Add a customer`customer.admin.create`Staff add a single customer by hand from the admin with a name and email.	Core`modules/customers/admin/manual-customer.ts`	Provider · many
CSV import`customer.admin.csv_import`A CSV import creates or updates customers from the rows of a spreadsheet file.	Core`modules/customers/admin/import-csv.ts`	Provider · many
Import from another platform`customer.admin.platform_import`A platform import copies customers and their marketing consent from a connected store, such as Shopify.	Core`modules/integrations/import/runtime/import-customers.ts`	Provider · many
CSV export`customer.admin.export`A CSV export writes the chosen customer fields to a spreadsheet file.	Core`modules/integrations/export/customer-export-fields.ts`	Provider · many
Merge duplicates`customer.admin.merge`A merge joins two customer records for the same person into one, keeping both records' orders.	Plugin	Provider · many

Phrase	Made of
RFM segmentation	customer.metric.recency_frequency_spend customer.segment.by_recency_frequency_spend
customer lifetime value	customer.metric.total_spent Vendors that add a forecast call it predicted lifetime value.
predicted CLV	customer.metric.predicted_value
magic link login	customer.account.login.email_link
passwordless login	customer.account.login.email_link
social login	customer.account.login.external_account
account invite	customer.account.login.invitation
customer tags	customer.profile.tag
customer metafields	customer.profile.custom_field
lapsed customers	customer.lifecycle.inactive
repeat customers	customer.lifecycle.stage
customer segments	customer.segment.by_rule
address book	customer.profile.address_book customer.account.page.addresses
order history	customer.account.page.orders
merge customers	customer.admin.merge

Customer data, segments and accounts

What the phrases mean

Phrases left out

Sources