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>