Calendar Settings
Calendar Months Ahead
This setting controls how many months appear in the calendar dropdown when patients use the “View More Dates” feature.
| Setting | Default | Range |
|---|---|---|
| Months Ahead | 18 months | Configurable |
What This Affects
Extended Calendar View
When patients click “View More Dates”:
- A full calendar opens in a modal
- Month/year dropdown shows available months
- This setting controls how many months appear
Example
With 18 months ahead:
- If today is January 2025
- Dropdown shows January 2025 through June 2026
- Patients can navigate to any month in that range
Configuring Calendar Months
The 18 month range is the furthest the View More Dates calendar can ever go. It is set by OutSmart, and most clinics never need it changed. If you would like it changed for your booking page, ask us through the Ask OutSmart widget.
To show patients fewer months than that, set How Far Ahead to Show Times in your booking page’s General Booking Preferences yourself. The list of times and the View More Dates calendar both stop at that limit. See How Far Ahead to Show Times.
Calendar Behavior
Initial Availability View
When a patient first views a service:
- Quick availability panel shows next ~20 available dates
- Stops at the How Far Ahead to Show Times limit, when your booking page has one
- Shows dates as they’re available
Extended Calendar
When patient clicks “View More Dates”:
- Full monthly calendar opens
- Shows all dates from now until X months ahead, or until the How Far Ahead to Show Times limit if that is sooner
- Available dates highlighted in primary color
- Unavailable dates greyed out
Month Navigation
- Arrow buttons navigate between months
- Month/year dropdown jumps to specific month
- New months load availability as needed
Availability vs. Calendar Range
What Determines Availability
The calendar range setting only controls display range. Actual availability depends on:
- Practitioner’s calendar schedule
- Existing appointments (blocked times)
- Working hours configuration
- Any booking prevention buffers
Showing vs. Available
A month may appear in the dropdown but have no availability:
- Practitioner hasn’t set hours that far out
- All slots are already booked
- Office is closed certain periods
Performance Considerations
Why Limit the Range
Limiting calendar range:
- Faster loading (less data to check)
- Keeps the picker focused on near-term dates
On-Demand Loading
The calendar uses smart loading:
- Initial data reused from quick view
- New months loaded as patient navigates
- Already-loaded months don’t reload
Recommended Settings by Practice Type
These are starting points for How Far Ahead to Show Times.
| Practice Type | Recommended Setting |
|---|---|
| General practice | 6-12 months |
| Specialists | 12-18 months |
| Surgical consults | 12-24 months |
| Quick services | 3-6 months |
Related Calendar Features
Booking Prevention Buffer
Separate from calendar range, you can set a minimum notice period:
- Prevents same-day booking
- Configured in OutSmart scheduling settings
- E.g., “Must book at least 24 hours in advance”
Date-Specific Availability
Calendar shows actual availability per date:
- Green/highlighted = times available
- Greyed out = no availability
- Real-time as slots are booked
Troubleshooting
Calendar Not Showing Enough Months
- Check How Far Ahead to Show Times in your booking page’s General Booking Preferences. When it is set, the calendar stops at that limit.
- When it is empty, the calendar shows 18 months.
No Availability Showing
Even with calendar range set:
- Practitioner calendar may not have hours configured
- All slots may be booked
- Check practitioner’s schedule in OutSmart
Calendar Loading Slowly
- Normal for initial load
- Subsequent months load faster
- Check internet connection
Next Steps
- Contact Display - Phone/email display settings
- Payments Overview - Payment settings