Repository navigation
Availability Rules
Jeremy Anderson edited this page Nov 3, 2026
·
1 revision
How the plugin decides which times to offer. If a time you expected is missing, walk down this page in order.
flowchart TD
A["Days requested (one month at a time)"] --> B["Keep days inside the booking window:<br/>today to today + 'Book up to' days,<br/>or the last posted shift if sooner"]
B --> C{"Day off?"}
C -->|"yes"| X["No times that day"]
C -->|"no"| D["Hours for the day:<br/>the type's own hours or your usual hours"]
D --> E["Start times every 'spacing' minutes<br/>that fit the whole appointment"]
E --> F["Drop times sooner than 'Minimum notice'"]
F --> G{"Daily cap reached?"}
G -->|"yes"| X
G -->|"no"| H["Busy times from every blocking calendar<br/>(fails closed if any can't be read)"]
H --> I["Plus bookings made here,<br/>widened by their own free time"]
I --> J["Plus shifts on the work schedule,<br/>widened by 'Keep free around each shift'"]
J --> K{"Start time, with free time before and after,<br/>overlaps anything busy?"}
K -->|"yes"| X2["Not offered"]
K -->|"no"| OK["Offered"]
| Rule | Setting | Effect |
|---|---|---|
| Hours | When people can book → each day, or the type's own hours | Only start times where the whole appointment fits inside a range |
| Start-time spacing | Type → spacing | 30 = :00 and :30; 15 = every quarter hour |
| Minimum notice | When people can book → Minimum notice (hours) | No times sooner than this from now |
| Booking window | Book up to (days ahead) | Last bookable day |
| Work schedule | Where bookings go → Open booking only as far as | Window ends at the last posted shift (optionally that Sunday); see Shift-Work Mode |
| Days off | When people can book → Days off | Whole days closed; one date or range per line |
| Free time before / after | When people can book | Clear time around each new appointment, also kept around appointments booked here |
| Free time around shifts | Where bookings go → Keep free before and after each shift | Clear time around work-schedule events; counts toward the above, doesn't stack |
| Daily cap | Most bookings per day (0 = no limit) | Counts payment holds too |
| Per-person cap | Upcoming bookings per person (0 = no limit) | Checked at booking time, by email address |
| Busy calendars | Each service's section | Events marked busy, tentative or out of office block; free/transparent and cancelled events don't |
2026-12-24
2026-12-31 to 2027-01-02
2027-07-04 # a comment after # is ignored
Invalid lines are reported when you save.
With Free time after = 15 and a 30-minute type:
| Existing event | Last start before it | First start after it |
|---|---|---|
| 10:00–11:00 in your calendar | 9:15 (ends 9:45 + 15 = 10:00) | 11:00 |
| 10:00–10:30 booked here (also keeps its 15) | 9:15 | 10:45 |
| Shift 12:00–16:00, 60 min kept free around shifts | 10:30 (ends 11:00, an hour before) | 17:00 |
Open times are cached for 2 minutes, so a visitor's page can be slightly out of date. Booking never relies on that cache:
sequenceDiagram
participant V as Visitor
participant S as Your site
participant C as Calendars
V->>S: Book 10:00
S->>S: Take the lock for 10:00 (atomic)
S->>C: Read busy times live (no cache)
alt Still free
S->>C: Create the event
S-->>V: Booked
else Taken meanwhile
S-->>V: "That time was just taken. Pick another time."
end
S->>S: Release the lock
| Thing | Time zone |
|---|---|
| Your hours, days off, notice | Your site's timezone (Settings → General) |
| What visitors see | Their own browser's timezone, labelled on the widget |
| Events in your calendar | Exact instants, so they land correctly in any calendar timezone |
| Daylight saving changes | Handled when the site timezone is a city |
Related: Calendar Services · Shift-Work Mode · Settings Reference · Troubleshooting
JAT Calendar Sync · free and open source (GPLv2 or later) · GitHub · by Jeremy Anderson Tech · This wiki is generated from docs/wiki/ in the repository; edit it there.
Set up
- Getting Started
- Calendar Services
- Google Calendar
- Outlook and Microsoft 365
- iCloud and CalDAV
- iCal Feeds
- Migrating from Anderson Appointment Booking
Use
- Appointment Types and Questions
- Availability Rules
- Shift-Work Mode
- Payments with Stripe
- Rescheduling and Cancelling
- Emails and Reminders
- Styling and Theming
- Block and Shortcode
- Settings Reference
Help
Developers