Medos Booking Docs
Configure

Calendar-only mode

Skip the doctor picker when your site already lists doctors.

If your website has its own doctor listing (with photos, bios, etc.), you probably don't want the widget to show its own doctor strip. Use calendarOnly: true and pass medosDoctorId to jump straight to the calendar.

MedosBooking.init({
  apiKey: "mk_...",
  mode: "modal",
  calendarOnly: true,
  medosDoctorId: "doc-123",
});

What the flag does

  • Hides the doctor selection strip.
  • Opens directly on the calendar for the doctor you pass in.
  • Locks the flow to that single doctor — the patient can't switch mid-flow.

When not to use it

If your workspace has multiple doctors and the patient hasn't picked one yet, leave calendarOnly off. The default flow lets them browse and pick.

Pattern — one button per doctor

The most common use of calendarOnly is a listing page where each doctor card has its own "Book" button:

<div class="doctor-card">
  <h3>Dr. Smith</h3>
  <button onclick="bookWith('doc-123')">Book with Dr. Smith</button>
</div>

<script>
  MedosBooking.init({ apiKey: "mk_..." });

  function bookWith(doctorId) {
    MedosBooking.open({
      calendarOnly: true,
      medosDoctorId: doctorId,
    });
  }
</script>

On this page