> ## Documentation Index
> Fetch the complete documentation index at: https://q.odontox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Appointments

> Book appointments from the calendar, choose a procedure from your Service Catalog, leave a booking unassigned, and reschedule with confidence.

The booking form is where most of a receptionist's day happens, so we have built it to be quick and unambiguous. This article covers how to book an appointment, pick the right procedure and duration, and book without a doctor when you need to.

## Booking an appointment

<Steps>
  <Step title="Open the calendar">
    From the sidebar. The Overview panel starts collapsed so the calendar gets the full canvas.

    <Frame>
      <img src="https://mintcdn.com/odontox-4b89ada8/iXRukJveHvqXoZEB/images/appointments-calendar-view.png?fit=max&auto=format&n=iXRukJveHvqXoZEB&q=85&s=78a61d45c9d52aa27501f6e3b03855d1" alt="Calendar view with New Appointment button highlighted" data-path="images/appointments-calendar-view.png" />
    </Frame>
  </Step>

  <Step title="Click New Appointment">
    The **New Appointment** button in the toolbar is the booking entry point. Clicking an empty slot on the calendar is display-only by default — see the note below.
  </Step>

  <Step title="Choose a duration">
    Pick the expected visit length. The duration picker offers `30 min (default)`, `1 hour`, and `Custom…` (5–480 minutes for the rare long case). New bookings default to 30 minutes.

    <Frame>
      <img src="https://mintcdn.com/odontox-4b89ada8/iXRukJveHvqXoZEB/images/appointments-duration-picker.png?fit=max&auto=format&n=iXRukJveHvqXoZEB&q=85&s=f9bccf2130fb1012ca8e1306a9b31d78" alt="Appointment duration picker" data-path="images/appointments-duration-picker.png" />
    </Frame>
  </Step>

  <Step title="Fill in the details">
    Choose the patient, the doctor (optional — see [Unassigned appointments](#unassigned-appointments)), the procedure, and the room. Add any notes for the visit.

    <Frame>
      <img src="https://mintcdn.com/odontox-4b89ada8/iXRukJveHvqXoZEB/images/appointments-booking-form.png?fit=max&auto=format&n=iXRukJveHvqXoZEB&q=85&s=1ebf3bdf36e3e5a47f59ed6e1dafce22" alt="Appointment booking form filled out" data-path="images/appointments-booking-form.png" />
    </Frame>
  </Step>

  <Step title="Save">
    The appointment lands on the calendar at its scheduled time, with a colour status ribbon reflecting its status.
  </Step>
</Steps>

<Note>
  **Clicking an empty slot does not open the booking form by default.** Bookings go through the **New Appointment** button. If you prefer the older behaviour, re-enable **click-to-book** under **Settings → Appointment Setup**.
</Note>

### Save & Book a new patient

If a walk-in patient is not in the system yet, open the patient form and click **Save & Book Appointment** instead of saving the patient first. This creates the patient record and opens the booking form in one step.

<Frame>
  <img src="https://mintcdn.com/odontox-4b89ada8/iXRukJveHvqXoZEB/images/appointments-save-and-book.png?fit=max&auto=format&n=iXRukJveHvqXoZEB&q=85&s=30193ca045feddfd0f4730b78fadb09f" alt="Save & Book Appointment button on patient form" data-path="images/appointments-save-and-book.png" />
</Frame>

## Choosing a procedure

The **Procedure** field is a searchable picker powered by your **Service Catalog**. Start typing to filter, and matching services appear grouped by category with their prices, so you can confirm you have picked the right treatment at the right fee.

If your clinic has not set up a Service Catalog yet, the picker falls back to a set of standard defaults, so you can always book a visit. Build out your catalog to make this field reflect your own treatments and pricing.

## Duration and time format

* **Default length.** New bookings stage a 30-minute appointment. Use `1 hour` or `Custom…` for longer visits.
* **Time format.** Your clinic's 12-hour or 24-hour preference (set under **Settings → Appointment Setup**) applies everywhere — the axis, cards, hover tooltips, and drag confirmations.

## Unassigned appointments

You do not have to choose a doctor at booking time. Leave the doctor field empty and the appointment is created as **unassigned**, which is useful when you are holding a slot for whoever is free, or booking ahead of a rota decision. Several unassigned bookings can share the same slot.

Wherever an unassigned appointment is listed — on the calendar, in the queue, and on its detail page — an amber **Assign doctor** badge appears. Click it to open a doctor picker (including any visiting doctors) and assign the visit.

In the Day view, when the **All doctors** filter is active, unassigned appointments collect in a dedicated **Unassigned** lane on the left. The lane is hidden when you filter to a single doctor.

<Warning>
  **Start appointment** stays disabled until a doctor is assigned. Assign one from the **Assign doctor** badge before the visit begins.
</Warning>

## Booking safeguards

The form validates each booking against your clinic's setup before saving:

* **Operating hours.** If a slot falls outside your open–close window, the message shows the appointment's start, the computed end, and the clinic's hours so you can pick a slot that fits.
* **Doctor schedules.** If a doctor is marked off that day, or the slot falls outside their configured working hours, the booking is declined with a clear message. Filtering the Day view to a doctor shrinks the time grid to that doctor's shift.
* **Duplicate guard.** A patient cannot hold two active appointments at the same time on the same day. Cancelled and no-show slots are excluded, so re-booking after a cancellation always works.

## Rescheduling

Drag a card to a new time on the Day or Week view, or open an appointment and choose **Reschedule**. Drops snap to 30-minute boundaries by default; switch to 15-minute snap under **Settings → Appointment Setup**. The reschedule picker offers 15-minute increments for fine placement.

Cancelled and no-show appointments can be rescheduled directly — those are exactly the cases where you need to move the patient to a new slot. Rescheduling resets the status to Scheduled automatically.

<Frame>
  <img src="https://mintcdn.com/odontox-4b89ada8/iXRukJveHvqXoZEB/images/appointments-drag-reschedule.png?fit=max&auto=format&n=iXRukJveHvqXoZEB&q=85&s=72e933a3857faa5eaa66fb3e923d106a" alt="Dragging an appointment to a new time slot" data-path="images/appointments-drag-reschedule.png" />
</Frame>

## Need help?

If anything is unclear, write to [support@odontox.io](mailto:support@odontox.io) or open a ticket from **Settings → Support**.

## Related articles

* [Scheduling Calendar](/clinical/calendar) — Day, Week, and Month views, drag-to-reschedule, and filters
* [Appointment Detail Page](/clinical/appointment-detail) — Where the visit workflow happens once an appointment is booked
* [Appointment Statuses & Workflow](/clinical/appointment-lifecycle) — Valid status transitions
