Pyle

Customer Addresses ​

What This Is ​

Customer Addresses are the saved shipping and billing addresses a customer can use in the account area and at checkout. They are part of the customer profile, not a separate feature.

When You Would Use It ​

Use Customer Addresses when you need to:

  • add a new shipping address for a customer
  • change the default billing address
  • update an address after a move or naming change
  • keep checkout faster by reusing saved addresses

Do not use the address area to edit a customer account's general profile. Use the customer profile for that.

Before You Start ​

Before you manage addresses, make sure:

  • you can access the customer record in admin or the my-account area in storefront
  • you know which address should be the default shipping address
  • you know whether the address is for billing, shipping, or both

How To Use It In The Admin ​

  1. Open the customer record.
  2. Go to the address section.
  3. Add a new address or choose an existing one to edit.
  4. Fill in the contact and location details.
  5. Save the address.
  6. If needed, set the address as the default shipping or billing address.

How To Use It In The Storefront ​

  1. Open My Account.
  2. Go to Addresses.
  3. Add a new saved address or edit an existing one.
  4. Set the address you want to use by default.
  5. Delete addresses you no longer want to keep.

What It Changes In The Storefront ​

Customer Addresses affect:

  • which address is preselected in checkout
  • what shipping and billing details the customer sees later
  • how easy it is to reuse the same destination across orders

Common Tasks ​

Add a new address ​

Use this when a customer needs a new shipping or billing destination.

Change the default address ​

Use this when the main shipping or billing destination has changed.

Edit an address ​

Use this when the contact or location details need to be corrected.

Delete an address ​

Use this when the address is no longer valid or needed.

Rules, Limits, And Things To Watch ​

  • In storefront, customers can only manage addresses that belong to their own account.
  • Changing the default address can affect later checkout behavior.
  • Address edits may affect shipping and territory-related behavior elsewhere in the system.

Troubleshooting ​

I cannot see the address section ​

Check that you are in the customer record in admin or the My Account area in storefront.

The address saved, but checkout still shows the old one ​

Refresh the cart or open checkout again. Some screens reuse the previous selection until they are reloaded.

I cannot delete an address ​

Make sure the address is not still being used as the current default or by an in-progress workflow.

  • Customers
  • Checkout
  • Shipping
  • Billing

Sources ​

  • packages/admin/src/Livewire/Admin/Customer/Page.php
  • packages/admin/src/Livewire/Admin/Customer/CreateAddressDialog.php
  • packages/admin/src/Livewire/Admin/Customer/EditAddressDialog.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