Skip to content

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

  1. Open Customers in the admin.
  2. Open the customer record.
  3. Use the address area to create a new address when needed.
  4. Select the address to use as the default shipping address.
  5. Select the address to use as the default billing address.
  6. Edit the address details if the address changes.
  7. Delete the address if it should no longer be kept on the customer record.

In Storefront

  1. Open My Account > Addresses.
  2. Create a new address if you need another saved address.
  3. Edit an existing address when the customer needs to change it.
  4. Set the default shipping or billing address from the saved addresses area.
  5. 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.

Sources

  • packages/admin/src/Livewire/Admin/Customer/CreateAddressDialog.php
  • packages/admin/src/Livewire/Admin/Customer/EditAddressDialog.php
  • packages/admin/src/Livewire/Admin/Customer/AddressTable/Block.php
  • packages/admin/src/Livewire/Admin/Customer/AddressTable/EditDialog.php
  • packages/framework/src/Http/Controllers/Api/Admin/CustomerAddressesController.php
  • packages/framework/src/Http/Controllers/Api/Storefront/CustomerAddressesController.php
  • packages/storefront/src/Livewire/Storefront/MyAccount/Addresses/Page.php
  • packages/storefront/src/Livewire/Storefront/Address/CreateDialog.php
  • packages/storefront/src/Livewire/Storefront/Address/EditDialog.php