How to Manage Customer Addresses
What This Task Does
This task covers the packaged customer-address flows in both admin and storefront.
Use it when you need to create a new address, change the default shipping or billing address, update an existing address, or delete an address that is no longer needed.
Before You Start
Make sure:
- you know whether you are working in admin or storefront
- the customer already exists
- you know which address should be the default shipping address
- you know which address should be the default billing address
Steps
In Admin
- Open
Customersin the admin. - Open the customer record.
- Use the address area to create a new address when needed.
- Select the address to use as the default shipping address.
- Select the address to use as the default billing address.
- Edit the address details if the address changes.
- Delete the address if it should no longer be kept on the customer record.
In Storefront
- Open
My Account > Addresses. - Create a new address if you need another saved address.
- Edit an existing address when the customer needs to change it.
- Set the default shipping or billing address from the saved addresses area.
- Delete any saved address that is no longer needed.
What Happens Next
After the address is updated:
- the customer record points to the correct default address where applicable
- storefront checkout can reuse the saved address
- the address is available for the customer-linked user flows that rely on it
Common Mistakes
- Mixing up shipping and billing defaults.
- Editing the wrong customer record when the customer has multiple user accounts.
- Assuming address changes happen only in storefront. Admin can manage them too.
- Forgetting that the packaged customer-address flow is shared across admin and storefront boundaries.
Related Guides
Sources
packages/admin/src/Livewire/Admin/Customer/CreateAddressDialog.phppackages/admin/src/Livewire/Admin/Customer/EditAddressDialog.phppackages/admin/src/Livewire/Admin/Customer/AddressTable/Block.phppackages/admin/src/Livewire/Admin/Customer/AddressTable/EditDialog.phppackages/framework/src/Http/Controllers/Api/Admin/CustomerAddressesController.phppackages/framework/src/Http/Controllers/Api/Storefront/CustomerAddressesController.phppackages/storefront/src/Livewire/Storefront/MyAccount/Addresses/Page.phppackages/storefront/src/Livewire/Storefront/Address/CreateDialog.phppackages/storefront/src/Livewire/Storefront/Address/EditDialog.php