ZenotiHelp

Appointment Book initialization

ZTZenoti Docs Team Updated October 6, 2026 3 min readGuide

The Appointment Book goes through a structured loading sequence every time it opens. Understanding this sequence can help you troubleshoot slow load times, explain what the calendar shows (and why) during startup, and set expectations for how quickly data becomes available.

Audience: Administrators and advanced front desk staff who need to understand how the Appointment Book loads.

Before you begin

  • You must have access to the Appointment Book at your center.
  • To adjust appointment interval or display interval settings, you need administrator-level access to configuration settings.

Permission: Viewing the Appointment Book requires the Appointments permission for your role. Admin path: Configuration > Security > Security Roles > [your role] > Appointments

What happens when the Appointment Book loads

When you open the Appointment Book, the system performs the following steps in sequence:

  1. Center and user context is established. The system identifies the active center, the logged-in user, and their permissions.
  2. Configuration settings are loaded. Appointment interval, working hours, color scheme, and feature flags (such as waitlist version and performance mode) are retrieved.
  3. Calendar time grid is constructed. The grid is built using the configured appointment interval. The time axis starts at the center's opening time and ends at the closing time.
  4. Provider schedules are fetched. The system loads the schedule for each provider assigned to the center on the selected date, including scheduled vs. unscheduled periods.
  5. Appointment data is loaded. All appointments for the selected date are retrieved and placed on the calendar.
  6. The calendar scrolls to the current time. When the selected date is today, the calendar automatically scrolls so the current time is visible in the viewport.

Some appointment data is loaded in the background while the book opens, which reduces the visible wait.

Calendar time grid

The time grid divides the working day into equal intervals based on your center's appointment interval setting (for example, 15 minutes, 30 minutes). Each row (vertical mode) or column (horizontal mode) in the grid represents one interval.

The grid only covers the configured working hours for the center. Time outside working hours is not displayed unless the Show non-working hours option is active.

Provider columns

In the Day View (the default view), each provider with a schedule for the selected date appears as a column. Providers without a schedule are not shown unless the Show all providers option is enabled.

The column header for each provider shows availability indicators that highlight scheduled time (available for bookings) vs. non-scheduled time.

Viewing previous and future dates

  • Use the date navigation arrows or the date picker in the toolbar to change the displayed date.
  • When you navigate to a new date, the system fetches fresh provider schedule and appointment data for that date.
  • Appointment data for adjacent dates may be prefetched depending on your center's performance configuration.

Tips

  • If the Appointment Book appears to load slowly, check with your administrator whether performance settings are enabled for your center.
  • If providers are missing from the calendar, confirm that their schedules are set for the selected date. You can enable Show all providers to include unscheduled providers.
  • Navigate to today's date to take advantage of the automatic scroll-to-current-time behavior, which positions the viewport at the current time without manual scrolling.

Troubleshooting

  • The calendar is empty or shows no providers. Verify that provider schedules exist for the selected date and that the correct center is selected. If the center was recently changed in another browser tab, refresh the page.
  • Appointments are not appearing after the book opens. This can occur when initial data loading is interrupted. Refresh the page and allow the full loading sequence to complete before taking any action.
  • The calendar does not scroll to the current time. This behavior only occurs when the selected date is today. If you are viewing a past or future date, the calendar does not auto-scroll. Navigate to today's date to restore the behavior.
Was this article helpful?
Your feedback helps us improve our documentation.