boxcart.dev

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

Add a second shop or collection point Adding a location with its address and collection instructions, giving it its own open days and time slots, and how customers choose where to collect. Needs BoxCart Pro. Watch on YouTube

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

FieldDescriptionRequired
NameDisplay name for the location (e.g. "Main Shop", "Market Stall")Yes
Address Line 1Street addressNo
Address Line 2Additional address lineNo
CityCity or townNo
CountyCounty, state, or regionNo
PostcodePostal or ZIP codeNo
PhoneContact phone number for this locationNo
EmailContact email for this locationNo
InstructionsCollection instructions shown to customers (e.g. "Enter via the side gate")No
ActiveToggle the location on or off. Inactive locations are hidden from customers—
Sort OrderNumeric value to control the display order of locations (lower numbers appear first)No
Location cards in the admin showing name, address, today's slots, and action buttons
Tip

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

Set your opening hours and collection times Opening an extra day, adding a time slot, adding an evening slot, copying slots to other days in one go, and what customers can then choose in your shop. Watch on YouTube

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:

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.

Tip

Opening hours determine which days appear in the date picker. Time slots (below) control the specific collection windows within those open days.

Time Slots

Limit orders per collection slot How customers see the places left, changing a slot's capacity, what happens when a slot is full, and choosing when the "slots left" count shows. Watch on YouTube

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:

FieldDescription
Day of WeekThe day this slot applies to (Monday–Sunday)
Start TimeWhen the collection window opens (e.g. 09:00)
End TimeWhen the collection window closes (e.g. 10:00)
CapacityMaximum number of orders for this slot (default: 10). Once capacity is reached the slot is shown as full
ActiveToggle individual slots on or off without deleting them
Time slot configuration for a location showing day, start/end times, and capacity

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.

  1. Click Copy to other days

    On the Time Slots panel, click Copy to other days on the day you want to copy.

  2. Choose the days

    Tick the days to copy to. Only open days are listed: open more days on the Open Days panel first.

  3. 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.

Copy Tuesday's time slots window with Wednesday, Thursday and Friday ticked, and the choice to keep or replace the slots those days already have
Tip

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

Close dates for holidays without losing orders Adding a closure for one date or several, what happens when orders are already booked on those dates, and opening a date again. Needs BoxCart Pro. Watch on YouTube

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:

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.

Important

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

Let one busy day take more orders Adding a capacity override for one slot on one date, seeing the orders already booked, and changing or removing it later. Needs BoxCart Pro. Watch on YouTube

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:

Common use cases include:

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

Set different collection times for Christmas Eve Adding special times for one date, starting from that day's usual times, closing early, and what replaces what. Needs BoxCart Pro. Watch on YouTube

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:

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".

The Add Special Times form for Monday 21 December, filled in with the usual Monday times, under a note saying these times replace the usual times for this date and listing the usual Monday times

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.

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.

The Special Times panel listing Sunday 20 December (normally closed) open 10:00 to 14:00, and Thursday 24 December open 9:00 to 13:00 instead of the usual 9:00 to 12:00 and 12:00 to 15:00

Collection Settings

Set when orders close Closing orders a set number of hours before each slot, or at a set time the day before, and the rule customers then see above the dates. Watch on YouTube

Global collection behaviour is configured under BoxCart → Settings → Collection. These settings apply across all locations.

SettingKeyTypeDefaultDescription
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

How far ahead customers can book, and the slot bar Setting the booking window, asking customers to choose a collection time before they add anything to the basket, hiding the days they can't book, and the slot bar at the top of your shop. Watch on YouTube

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.

SettingKeyDefaultDescription
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:

  1. The customer visits the products page
  2. The slot selector modal opens automatically, prompting them to choose a location, date, and time slot
  3. Once a slot is selected, the products page loads and the customer can browse and add items to their basket
  4. The selected slot is stored on the basket and carried through to checkout
Slot selector modal on the products page prompting the customer to choose a collection window
Tip

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: