Core Concepts

Locations

Locations

A location represents a physical place of business (a branch, salon, clinic, studio, etc.). Each location has its own work hours, capacity rules, and set of available services.

Work Hours

Work hours are defined per day of the week. Each day can be independently toggled on or off (isActive). When a day is inactive, no appointments can be booked on that day at this location regardless of employee availability.

Hours are specified as start/end in hour and minute fields. For example: Monday 09:00–18:00.

Timezone

Each location has its own timezone. Appointment times are stored and displayed in the location's timezone, so multi-location businesses spanning different regions work correctly without manual offset calculations.

Capacity

Location capacity controls how many simultaneous bookings are allowed. Two values work together:

  • Per-employee concurrency — how many customers a single employee can serve at the same time. For 1-to-1 services (e.g. a haircut) this is 1. For group sessions or classes this can be higher.
  • Concurrent capacity — a physical ceiling independent of staffing. For example: a clinic has 5 treatment rooms, so no more than 5 appointments can overlap regardless of how many employees are on shift.

The effective capacity at any moment is: min(perEmployeeConcurrency × activeEmployees, concurrentCapacity).

If concurrent capacity is not set, only staffing limits apply.

Available Services

By default, all services in your organisation are bookable at every location. You can restrict a location to a specific subset by setting its available services list. Any service not in that list will be hidden when booking at that location.

External Bookings

When Allow external bookings is enabled, this location appears in the public-facing booking flow and can receive appointments from customers who are not registered in your system. When disabled, only internal staff can create bookings for this location.

Notifications

When Send notifications is enabled, customers receive email confirmations and reminders for appointments at this location. You can turn this off per location — useful for internal-only or testing locations.