Inventory Locations
What This Is
Inventory Locations are the places in Pyle where stock is held and, when enabled, where customers can pick up orders.
In day-to-day operations, this is the location record that connects a vendor, a real address, pickup availability, and the inventory rows that depend on that location.
When You Would Use It
Use Inventory Locations when you need to:
- add a new warehouse or pickup location
- change the address or contact details for an existing location
- turn customer pickup on or off for a location
- disable a location that should no longer supply stock
Do not use this area to manually adjust stock counts. Inventory quantities are reviewed elsewhere and are usually driven by sync or mapping workflows.
Before You Start
Before you create or edit an Inventory Location, make sure:
- the vendor already exists
- you know the location name and vendor location code
- you have the full address and contact details
- you know whether the location should accept customer pickup
- you understand that deactivating a location can remove related inventory from active use
How To Use It In The Admin
- Go to
Settings > Locationsfor the global location list. - Create a new location or open an existing one to edit it.
- Choose the vendor when needed.
- On the General tab, fill in the main operational fields:
- location name
- location code
- contact name
- phone
- contact emails
- address, city, country, state, postal code
- Still on the General tab, decide whether the location should:
- accept customer pickups
- auto-send pickup details when fulfillment is confirmed
- remain active
- Add a bilingual Pickup Note (EN) and Pickup Note (FR) if you want a custom message to appear in the customer's pickup confirmation email when this location is the pickup point.
- Switch to the Opening Hours tab to define when the location is open each day. Add one or more time windows per day using the
+button. - Save the location.
You can also review a vendor's locations from the vendor detail page, but the main management flow is still the shared location form.
What It Changes In The Storefront
Inventory Locations can affect the storefront directly.
Depending on the setup, they can change:
- which pickup-capable locations customers can select
- which location is chosen as the active storefront location
- which stock and shipping options are available from that location
- what address and contact details are shown in pickup-related flows
If a location is deactivated, the storefront can lose availability tied to that location.
Common Tasks
Add a new warehouse or pickup location
Create the location, assign it to the right vendor, and enter the full contact and address details.
Turn pickup on or off
Use the pickup checkbox in the location form. This affects whether the system can expose pickup behavior from that location.
Add or revise the pickup note
Open the location's create or edit dialog, go to the General tab, and fill in the Pickup Note (EN) and Pickup Note (FR) fields. These notes appear in the customer's pickup confirmation email when this location is the final pickup point.
Update opening hours
Open the location's create or edit dialog and switch to the Opening Hours tab. Add, remove, or revise time windows for each day of the week.
Change the contact details for a location
Update the contact name, phone, or contact emails when the warehouse or pickup contact changes.
Disable a location
Use this when a warehouse should no longer be used. Do it carefully because it can affect live availability.
Rules, Limits, And Things To Watch
- Every location belongs to a vendor.
- A valid postal code and full address are required in the packaged form.
- Turning pickup on can create or refresh pickup-related shipping behavior automatically.
- Deactivating a location can remove related inventory from active supply.
- Pickup notes are bilingual. If both languages are filled in, the customer sees the note for their locale. Fill in at least the English note for broad coverage.
- Opening hours accept multiple time windows per day. The format is normalised internally using spatie/opening-hours.
- When a fulfillment request routes through one or more transfer locations, the last transfer location becomes the pickup address and note source for the confirmation email—not this inventory location. If no transfer locations are on the request, the inventory location's address and note are used.
Troubleshooting
The location does not appear where I expect
Check that the location is still active and that the address was saved correctly.
Customers cannot use pickup from this location
Make sure pickup is enabled for the location and that your environment has the related pickup shipping method configured.
I changed a location and storefront availability changed unexpectedly
That can be normal. Locations affect active inventory and pickup behavior, not just address labels.
I cannot find a location under a vendor
Open the vendor detail page and review its locations table, or use the global Settings > Locations list.
Related Features
- Vendors
- Vendor Data Feeds
- Vendor Mappings
- Stock History
- Transfer Locations
Sources
packages/admin/src/Livewire/Admin/Settings/Locations/DataTable/CreateDialog.phppackages/admin/src/Livewire/Admin/Settings/Locations/DataTable/EditDialog.phppackages/admin/resources/views/components/settings/locations/data-table/form.blade.phppackages/framework/src/Actions/ProductInventoryLocation/UpdateProductInventoryLocation.phppackages/storefront/src/StorefrontSession.php