Skip to content

How to Create or Update an Inventory Location

What This Task Does

This task creates a new inventory location or updates an existing one so the right vendor, address, pickup behavior, and active status are in place.

Use it when you are onboarding a warehouse, changing location details, or turning pickup behavior on or off.

Before You Start

Make sure:

  • the vendor already exists
  • you know the location name, code, and full address
  • you know whether the location should accept customer pickup
  • you understand that disabling a location can affect active inventory

Steps

  1. Go to Settings > Locations.
  2. Create a new location or open an existing one to edit it.
  3. Choose the vendor if the form asks for it.
  4. Fill in the key fields:
    • location name
    • location code
    • contact name
    • phone
    • contact emails
    • address
    • city
    • country, state, postal code
  5. Decide whether the location should:
    • accept customer pickups
    • auto-send pickup details on confirmation
    • remain active
  6. If you are editing an existing location, update opening hours if needed.
  7. Save the location.

What Happens Next

After saving:

  • the location appears in the admin lists
  • pickup-related behavior can be created or refreshed automatically
  • storefront location selection and downstream inventory availability can change

Common Mistakes

  • Creating the location before the vendor exists.
  • Entering incomplete address information.
  • Disabling a location without realizing it can remove related inventory from active use.
  • Expecting stock counts to be edited from the location form.

Sources

  • packages/admin/src/Livewire/Admin/Settings/Locations/DataTable/CreateDialog.php
  • packages/admin/src/Livewire/Admin/Settings/Locations/DataTable/EditDialog.php
  • packages/admin/resources/views/components/settings/locations/data-table/form.blade.php
  • packages/framework/src/Actions/ProductInventoryLocation/UpdateProductInventoryLocation.php