Locations & Collection
Configure collection locations, set opening hours, create time slots and copy them between days, manage closures and capacity overrides, and control how customers select their collection window.
Multi-Location Setup Pro
Requires BoxCart Pro. The Free plugin supports a single collection location. Running more than one location requires BoxCart Pro. See the Free vs Pro comparison.
BoxCart supports multiple collection locations. Each location represents a physical pickup point where customers can collect their orders. Navigate to BoxCart → Locations and click Add Location to create a new one.
The admin Locations page uses a card grid layout. Each card displays the location name, address, today's available slots, pending orders count, and action buttons for editing, viewing the schedule, and deleting.
Location Fields
| Field | Description | Required |
|---|---|---|
| Name | Display name for the location (e.g. "Main Shop", "Market Stall") | Yes |
| Address Line 1 | Street address | No |
| Address Line 2 | Additional address line | No |
| City | City or town | No |
| County | County, state, or region | No |
| Postcode | Postal or ZIP code | No |
| Phone | Contact phone number for this location | No |
| Contact email for this location | No | |
| Instructions | Collection instructions shown to customers (e.g. "Enter via the side gate") | No |
| Active | Toggle the location on or off. Inactive locations are hidden from customers | — |
| Sort Order | Numeric value to control the display order of locations (lower numbers appear first) | No |
Use the Active toggle to temporarily hide a location without deleting it. This is useful for seasonal locations or when a site is temporarily unavailable.
Opening Hours
Each location has its own weekly schedule. Go to BoxCart → Locations (on Pro, click Manage on the location card), then open the Open Days panel.
The schedule displays all seven days of the week. For each day you can:
- Toggle the day Open or Closed
- Closed days will not appear in the slot selector for customers
Opening hours are stored per-location with a unique constraint on the combination of location and day of week, ensuring each location has exactly one schedule entry per day.
Opening hours determine which days appear in the date picker. Time slots (below) control the specific collection windows within those open days.
Time Slots
Time slots define the specific collection windows available at each location. Open the location and select the Time Slots panel to manage them. Guided Setup can create your first location and its slots for you.
Each time slot is configured per-location and per-day of the week. The following fields are available:
| Field | Description |
|---|---|
| Day of Week | The day this slot applies to (Monday–Sunday) |
| Start Time | When the collection window opens (e.g. 09:00) |
| End Time | When the collection window closes (e.g. 10:00) |
| Capacity | Maximum number of orders for this slot (default: 10). Once capacity is reached the slot is shown as full |
| Active | Toggle individual slots on or off without deleting them |
You can create multiple slots per day to offer different collection windows. For example, a location open on Saturday might have three slots: 09:00–10:00, 10:00–12:00, and 14:00–16:00.
How customers see the times. Times follow your WordPress clock, under Settings → General → Time Format. With a 12-hour format a slot reads 9:00am – 10:00am; with a 24-hour format (such as H:i) it reads 09:00 – 10:00. The slot picker, basket, checkout, order pages, emails, the pick list and BoxCart Today all follow the same setting (since 1.8.2).
Copying slots to other days
To give several days the same slots, set up one day and copy it. A Copy to other days button appears next to the slot count of any day that has slots, as long as the location is open on more than one day.
-
Click Copy to other days
On the Time Slots panel, click Copy to other days on the day you want to copy.
-
Choose the days
Tick the days to copy to. Only open days are listed: open more days on the Open Days panel first.
-
Choose what happens to their slots
Keep them, and add the copies leaves the slots those days already have and adds the copies, skipping any slot with the same start and end time as one already there. Replace them with the copies deletes those days' slots first (and, on Pro, any capacity overrides set on them).
Copies keep each slot's capacity and whether it's active. Orders already booked aren't changed.
Set the Capacity to a higher number for busier periods. You can also use Capacity Overrides to adjust capacity for specific dates without changing the default.
Location Closures Pro
Requires BoxCart Pro. Location closures are a Pro feature. See the Free vs Pro comparison.
Closures let you block specific dates for a location. This is useful for bank holidays, maintenance days, staff holidays, or any ad-hoc day when a location will not be accepting collections.
Open the location and select the Closures panel. For each closure you specify:
- Closure Date: the specific date the location will be closed
- Reason (optional): a text note explaining the closure (e.g. "Bank Holiday", "Staff Training Day")
Each location can only have one closure entry per date. Closed dates are automatically excluded from the customer-facing date picker, so no collection slots will be offered on those days.
Closing dates that already have orders
If orders are already booked for collection on the dates you're closing, BoxCart lists them (order number, customer and date) and asks before it closes the dates. Closing doesn't change those orders. Once you choose Close anyway, the Closures panel lists the orders with links, so you can contact the customers to move or cancel them. Cancelled orders aren't counted.
Closures take priority over opening hours. Even if a day is normally marked as open, adding a closure for that date will prevent any slots from being available.
Capacity Overrides Pro
Requires BoxCart Pro. Per-date capacity overrides are a Pro feature. See the Free vs Pro comparison.
Capacity overrides let you change the order limit for a specific slot on a specific date, without altering the slot's default capacity. This is managed from the Capacity panel on the location's page.
Each override requires:
- Slot: the time slot to override
- Override Date: the specific date the override applies to
- Capacity: the new maximum number of orders for that slot on that date
Common use cases include:
- Increasing capacity for a slot you expect to be busy (e.g. the day before a bank holiday)
- Reducing capacity when you have limited staff
- Setting capacity to zero to effectively close a single slot on a particular date without creating a full closure
Each slot can only have one override per date. Saving an override for a slot and date that already has one changes it, so the new limit applies straight away (there's no gap where the usual capacity applies).
Changing an override, and orders already booked
Each override in the list shows how many orders are already booked for that slot on that date (for example "Override: 20 · 23 booked"). Click Edit to change the limit in place. The Add form shows the same booked count once you pick a date and slot.
You can set a limit below the number already booked. BoxCart warns you first: the orders stay booked, and no more can be placed until the number falls below the limit.
On a date with special times, the usual slots don't apply, so their overrides would do nothing and BoxCart won't add one. Set the number of orders for each special time instead.
Special Times Pro
Requires BoxCart Pro. See the Free vs Pro comparison.
Special times give a particular date its own collection times: shorter hours on Christmas Eve, longer ones before a bank holiday, or opening on a day you're usually closed. On that date they replace the location's usual time slots. Every other date keeps the weekly schedule.
Open the location and select the Special Times panel, then click Add Special Times:
- Date: the day the times apply to (today or later)
- Collection times that day: one or more time ranges (up to 24), each with the number of orders it can take. Times can't overlap.
When you pick a date, the form fills in that day of the week's usual times (from the Time Slots panel), so you only change what's different: move a start time, remove a slot, or add one. If the location is usually closed that day, you start with one empty time. Once you've changed the times, picking another date doesn't overwrite them.
A note at the top of the form says that these times replace the usual ones, and what the usual times are on that day, for example "Usual times on Mondays: 12:00–16:00, up to 20 orders", or "Usually closed on Sundays".
For example, a shop that's normally open 12pm to 4pm on Mondays can open 9am to 4pm on Monday 21 December, and close at 1pm on Christmas Eve instead of 4pm.
- Usually closed days: special times open the date even if the location is normally closed that day of the week.
- Closures still win: a closure on the same date closes it. The panel marks such dates "Closed (closure)".
- Capacity: each special time has its own number of orders. Capacity overrides apply to the usual weekly slots only.
- Order cut-off: unchanged. With a fixed cut-off (for example 1pm the day before), ordering for the date closes at the same time as usual. With a cut-off a number of hours before each slot, it counts from each special time's start.
- Orders already booked keep their time. If any are booked for a time you're no longer offering, BoxCart lists them before saving and keeps listing them on the panel, so you can contact those customers. Nothing is moved automatically.
Each date in the list shows what it replaces, such as "Instead of the usual 12:00–16:00", or "Normally closed" for a day the location is usually closed. To change a date's times, click Edit. To go back to the usual times, click Remove. Adding special times for a date that already has some asks before replacing them. Past dates drop off the list.
Collection Settings
Global collection behaviour is configured under BoxCart → Settings → Collection. These settings apply across all locations.
| Setting | Key | Type | Default | Description |
|---|---|---|---|---|
| When Orders Close | cutoff_mode |
lead_time | fixed |
lead_time |
How ordering closes for each collection. lead_time: a set number of hours before each slot starts (Lead Time below). fixed: a set time on a day before the collection day (Order Cut-off below), for shops that pick and pack the day before. Added in 1.4.0. |
| Lead Time | lead_time_hours |
Number (0–168) | 24 |
Used when orders close a set number of hours before each slot. For example, a value of 24 means customers must book at least 24 hours in advance. Measured in your site's timezone (Settings → General) from 1.4.0. |
| Order Cut-off | cutoff_days_before, cutoff_time |
Days (0–7) and a time (HH:MM) | 1, 12:00 |
Used when orders close at a set time before the collection day. "The day before at 13:00" means orders for a Wednesday collection close at 1pm on Tuesday, whatever time the slot starts. 0 days closes orders on the collection day itself (never after a slot has started). Customers see the rule above the collection dates, and dates whose slots have all closed show as closed. Added in 1.4.0. |
| Days Available | days_ahead |
Number (1–90) | 14 |
How many days ahead customers can book collection slots. Limits the date picker range. |
| Slot Reservation Time | slot_reservation_minutes |
Number (0–120) | 30 |
How long a slot is held for a customer before the reservation expires. A slot is only held once the customer has something in their basket. A countdown timer shows the customer how long they have to complete checkout. Set to 0 to disable reservations. |
| Hide Unavailable Dates | hide_unavailable_dates |
Toggle | false |
When enabled, dates the customer cannot book (closed days, days with no slots, fully booked days) are dropped from the date strip entirely instead of being shown greyed out. Useful for shops that only open one or two days a week. Added in 1.3.0. |
| Slot Availability Display | slot_availability_display |
always | low | never |
always |
Whether the remaining-slot count ("3 slots left") appears against each time slot. low shows it only once a slot has 3 or fewer places left. never hides it entirely, which is the right choice if you have not set a real capacity on your slots, since BoxCart falls back to a capacity of 10. Fully booked slots are still labelled as full under every option. Added in 1.3.0. |
Slot-First Shopping
By default, customers can browse products and add items to their basket before selecting a collection slot. Enabling slot-first shopping reverses this flow so that customers must choose a location, date, and time slot before they can begin shopping.
| Setting | Key | Default | Description |
|---|---|---|---|
| Show Slot Selector on Products Page | show_slot_selector_on_products |
true |
Displays the collection slot bar at the top of the products page, so customers can choose their collection time while they shop. Turning this off also disables slot-first shopping. |
| Require Slot Selection Before Shopping | require_slot_before_shopping |
false |
When enabled, customers must select a collection slot before they can browse and add products. The slot selector modal is presented immediately on the products page. Only applies when the slot selector is shown. |
When slot-first shopping is active:
- The customer visits the products page
- The slot selector modal opens automatically, prompting them to choose a location, date, and time slot
- Once a slot is selected, the products page loads and the customer can browse and add items to their basket
- The selected slot is stored on the basket and carried through to checkout
Slot-first shopping is ideal for businesses that prepare orders in advance and need to know the collection time before the customer starts shopping. If you prefer a more flexible experience, leave this disabled and customers can select their slot at checkout instead.
Slot Bar
The collection slot bar is displayed at the top of the products page and shows the customer's currently selected collection slot. It provides a quick visual summary of the chosen location, date, and time, and allows the customer to open the slot selector modal to change their selection.
The slot bar has three visual states:
- Empty: no slot selected yet; prompts the customer to choose a collection time
- Valid: a slot is selected and confirmed
- Warning: the selected slot has an issue (e.g. it has expired or capacity has been reached)