Comprehensive mapping of how Magento_Customer integrates with other core modules through direct dependencies, plugins, observers, and service contracts.
The Customer module is a foundation module that provides customer identity services to nearly all customer-facing and admin modules in Magento. It integrates through five primary patterns.
Modules Customer depends on (EAV, Directory)
Modules that depend on Customer (Sales, Quote, Checkout)
Customer intercepts other modules
Customer provides interfaces for others
Loose coupling via events and observers
REST/GraphQL endpoints for external systems
These modules are required by Customer and defined in module.xml.
Entity-Attribute-Value Pattern
Customer and Address entities use the EAV pattern for flexible custom attributes and metadata management.
AbstractEntityGeographic Data
Address management requires country and region data for validation, formatting, and dropdown population.
These modules depend on Customer and use its services for identity, grouping, and personalization.
Order Management
Orders associate with customers via foreign keys and denormalized data.
Email Synchronization
Observer updates all order emails when customer email changes
Customer Group Pricing
Order pricing uses customer group for discount calculations
Shopping Cart
Shopping carts support both guest and logged-in customers with automatic binding on login.
Guest-to-Customer Conversion
Observer assigns guest cart to customer on login
Email Sync
Active quote email updated when customer email changes
Checkout Process
Checkout uses customer address book for logged-in users and supports guest checkout flow.
Address Population
Loads saved addresses from customer repository
Default Address Selection
Pre-fills billing/shipping from customer defaults
Customer Wishlists
Wishlists are per-customer with cross-module plugin on email notifications.
Database FK
One wishlist per customer (or multiple in Enterprise)
Email Plugin
Adds wishlist data to customer email notifications
Product Pricing
Customer groups affect tier pricing and catalog price rule eligibility.
Tier Pricing
Different prices per customer group and quantity
Catalog Rules
Rules target specific customer groups
Tax Calculation
Customer group's tax class determines applicable tax rates.
Tax Class Mapping
Each customer group has a tax class (Retail, Wholesale, etc.)
VAT Validation
Observer validates EU VAT numbers and assigns groups
Full Page Cache
Depersonalization plugin removes customer data from cached pages.
Depersonalization Plugin
Clears customer data before caching page HTML
Customer Sections
AJAX endpoint loads private customer data post-render
Subscriptions
Newsletter subscriptions link to customers via optional foreign key.
Registration Integration
"Subscribe to newsletter" checkbox during registration
Email Synchronization
Subscription email must match customer email
Product Reviews
Product reviews can be tied to customers or submitted as guest.
Optional FK
customer_id NULL for guest reviews
Dashboard Display
Customer sees "Your reviews" in account dashboard
Customer module exposes service contracts via REST and GraphQL for headless and third-party integrations.
Auto-generated from Service Contracts
Customers can only access their own data. Admins can access any customer via CustomerAuthorization plugin.
Headless Commerce
query {
customer {
firstname
lastname
email
addresses {
street
city
region { region }
postcode
}
}
}mutation {
updateCustomer(input: {
firstname: "Jane"
lastname: "Doe"
}) {
customer {
firstname
}
}
}Quick reference for how Customer integrates with each module type.
| Module | Integration Type | Key Mechanism |
|---|---|---|
| Magento_Eav | Direct Dependency | EAV entity inheritance |
| Magento_Directory | Direct Dependency | Address validation |
| Magento_Sales | Email Sync | Observer on customer save |
| Magento_Quote | Guest Conversion | Observer on customer login |
| Magento_Checkout | Address Population | Service contract calls |
| Magento_Wishlist | Cross-Module Plugin | Plugin on EmailNotification |
| Magento_Catalog | Group Pricing | Database foreign keys |
| Magento_Tax | Tax Class | Customer group tax class |
| Magento_PageCache | Depersonalization | Plugin on Layout |
| Magento_Backend | Admin UI | UI components, ACL |