How bookings work
Slot holds, deposits, confirmations and the manage links patients use to reschedule or cancel.
The patient's journey
When some of your bookable types are for new or existing patients only (Who can book under Choose what's bookable), the page first asks Are you already a patient with us? — I'm new here or I'm already a patient — and then lists only the types for that answer, plus those for Everyone. When every type is for everyone, the page starts at the list as before.
A patient then books in these steps: appointment type → location (multi-site practices) → practitioner (or "any", which resolves to the first free clinician) → a date & time from the live availability → their details → Check and confirm. A step counter and bar show how far along they are. On the first three steps the patient selects a card — each appointment type shows its duration, any deposit and Practice confirms, and the chosen one expands to its description — and moves on with Select & continue. The time and details steps show what they've picked so far with Change to go back. Check and confirm shows the date, time, clinician, location, their name and contact, and any deposit; the booking is made only when they press its button. What happens next depends on the appointment type:
- No deposit, no confirmation — the appointment is booked instantly and the booking confirmation message goes out.
- Deposit — the chosen slot is held for 60 minutes while the patient pays through Stripe Checkout. Payment converts the hold into a booking; walking away releases the slot automatically (30 minutes for no-deposit types that stall at the details step).
- Practice confirms — the booking lands as a request. Your team approves or declines it from Leads; the patient's confirmation and reminders only go out on approval.
Once booked, the page offers Add to calendar (a calendar file for the visit) and Directions to the site.
Held slots are invisible to other bookers, so two patients can never take the same time — a slot that's snapped up mid-checkout answers "that time is no longer available" and offers the picker again.
What the details step asks is your choice: the details you set to Optional or Required under Patient details, then your own questions — see Choose what the form asks. A detail or question marked Required has to be filled in before the form can be sent. The booking card in the chat widget asks the same.
At the details step the patient gives a name and at least one contact — an email address or a mobile number. A mobile written any usual way is accepted (07700 900123, +44 (0)7700 900123, 44 7700 900123, an extension or note after it). If a phone cannot be read, or an email is mistyped, the booking still goes ahead: the value is stored on the patient exactly as typed (and on the lead's capture record) for your team to correct, and an unreadable phone opens a Contact could not be read item in Intake review. Only a details step with no email address and no mobile number at all is refused.
Patients see the next seven days with free times, however far ahead they are — up to a year. Each day lists its times (a long day shows its first eight with Show all times for the rest), stretches with nothing free fold into one thin "No times …" line, and seven more days appear as the patient scrolls to the end of the list; there is nothing to click to page forward. Jump to date opens a date picker for any day in the coming year and lists the next free days from there, and Earliest dates returns to today. When a connected practice-management-system location has more than 10 linked practitioners, the patient must choose a practitioner before Smileline queries the provider diary; the unbounded Any practitioner search is unavailable.
The one-page design
The steps above are the Standard design. With the One-page design — see Choose the design — the patient books on one card: there are no steps to move through and no Check and confirm. One press checks the form and books.
From the top, the card shows:
- The visit — its name and length. Where there is a choice, the patient picks from lists named Appointment, Location and Practitioner. When some of your types are for new or existing patients only, Are you already a patient with us? is asked here, as two buttons.
- Choose your time — the next five days with free times, with arrows for later and earlier days. The chosen day lists its times as buttons: the first twelve, then Show all 20 times (with that day's count) for the rest. There is no Jump to date.
- Your details — the chosen time with Change, then the same form as the details step: what you set under Patient details, your own questions, and what a location's practice management system needs.
- Book appointment — the only button. It reads Book & pay £50 for a type with a £50 deposit, and Request booking for a type the practice confirms. The deposit amount, and a line saying the practice confirms the request before it's booked, show just above it.
Pressing the button with no time chosen says Choose a date and time and takes the patient back to the times. Otherwise the booking goes through as described above: booked instantly, held while the deposit is paid, or sent as a request.
Once booked, the card shows You're booked! with the date and time, Add to calendar, Directions, and a line pointing to the manage link in the confirmation message. A request shows Request received or We've got your request with the date and time instead. Where the page — or the space your website gives the embed — is at least 900 pixels wide, the card has two columns: the visit and the times on the left, the details and the button on the right.
The design applies to the hosted page and the embed. Manage links, recall booking links and the page a patient returns to after paying a deposit keep the standard look, and so does the booking card in the chat widget.
New patients at practices with a practice management system
Where a location's diary is kept in a connected practice management system, a patient who has no chart there yet can book online too. Smileline looks for their chart by every email address and phone number it has, and checks the date of birth and name before using one, so a parent and a child who share a phone are never mixed up. When there is no chart, it opens one, then books.
Open Dental opens a chart without a date of birth, so an Open Dental location needs none: the page asks for one there only if you set Date of birth to Optional or Required under Patient details. There a patient who gives a first name, a last name and a mobile number is recognised by the mobile number and full name: Smileline uses the chart when exactly one active chart has that number and the same first and last name, and matches its own patient record the same way. If the number is only on someone else's chart, or two charts match, the booking waits for your team — see Recognising a patient without a date of birth.
The details step always asks for what that system needs to open a chart, each required, whatever you chose under Patient details:
| Practice management system | Always asked for |
|---|---|
| Dentally, personal token (UK) | Title, Sex, Date of birth, Address and Postcode |
| Dentally NexGen (UK) | Title and Date of birth |
| CareStack | Date of birth |
| Open Dental | Nothing extra |
The date of birth is typed in three boxes: day, month and year (month first at sites in the Americas). A date that doesn't exist, or one later than today, is refused before the booking is sent.
Until the practice system has the booking, the patient sees We've got your request — the practice will confirm shortly — rather than You're booked!. Usually that is only a moment. If something stops it — a detail the system still needs, a chart Smileline can't be sure is theirs, or the system refusing the booking — it waits for your team under Bookings needing attention, and the patient's booking confirmation goes out once it goes through.
A booking waiting there is never released on a timer: the slot stays held until your team acts. That holds for a paid deposit too — the booking counts as paid and awaiting the practice, not as a lost slot. A hold whose deposit was never paid still lapses after its hour, as above.
Bookings made by the AI receptionist or by AI replies in a message conversation work the same way: until the practice system has the booking, they tell the patient the practice will confirm it by text rather than that it is booked.
What lands in the CRM
Every booking — completed or abandoned — creates or matches the patient by email/phone, stamps the configured lead source, and records an attribution touch with booking as the channel. A booking started from AI chat continues the conversation's active journey when the matched patient and the appointment type's default treatment both agree; otherwise Smileline opens the normal new journey for that treatment. Instant bookings appear on the Calendar immediately and move the patient's open enquiry to your board's consultation-booked stage, so its new-enquiry follow-ups stop; abandoned holds cancel themselves and leave the lead behind with a Call now card. When a patient moves their booking online, they get the Appointment moved message rather than a second booking confirmation.
The answers to your own questions and the patient's message (Anything we should know?) are written on the appointment note, one line each. Your diary shows the note, and so does your practice management system at a location that books into it. The patient's timeline keeps the answers and the message in full, and the answers also show on the lead. The appointment note holds up to 2,000 characters: anything longer is cut short on the note only and stays whole on the timeline. A booking the patient moves online keeps them.
Confirm-mode requests raise a Confirm online booking card on Leads: open it, and approve (the patient's confirmation goes out, reminders arm and the enquiry moves to consultation booked) or decline with a cancellation reason.
While a practice on the free plan is past its patient limit, no slot can be reserved: the patient sees Request received, the request is held in the review queue, and it becomes an enquiry — with the requested time in its note for you to confirm by hand — once the practice subscribes. The patient's answers and message are on that enquiry's timeline.
A deposit that settles after its hold expired is never lost: if the slot is still free the booking revives automatically; if it was taken, a Deposit paid but the slot was lost task tells your team to call and rebook — the money stays on the deposit, ready to refund or reallocate. Once that review exists, cancelling its task never revives the old appointment; staff must explicitly rebook or refund.
Deposits
Booking deposits ride the same Stripe Connect account and lifecycle as staff-sent deposit requests: the paid deposit shows on the patient record, auto-refunds when the consultation is attended, and follows your no-show policy otherwise. Cancelling an unpaid hold voids its payment link; a paid deposit on a patient-cancelled consultation carries over to the next consultation booked on that enquiry, and until then waits under Held for review in Payments → Deposits for your team to refund or forfeit.
If a required deposit cannot be taken because Stripe or the connected account is unavailable, Smileline disables that appointment type and does not create a free booking. The patient can try again later or contact the practice. Staff may separately record money collected at the practice.
When a PMS appointment operation has started, the manage link becomes read-only and the patient is asked to call the practice. This applies while the provider outcome is still reconciling as well as after confirmation, so an ambiguous provider booking can never reappear after a local-only cancellation. Expiry rejects provider work that never activated. Once a live hold has been claimed, cleanup retains it while the provider outcome reconciles. If the provider booking completes after the original request disconnects, Smileline finishes the local booking in the background; an irreconcilable provider/local conflict creates an urgent review task instead of repeating the provider booking.
Manage links: reschedule and cancel
Confirmation and reminder messages carry a manage link (the {{appointment.manageUrl}} merge tag). From it, patients can:
- see the appointment's status, time, practitioner and location;
- reschedule — pick a new time from live availability; the deposit carries over;
- cancel — with an optional reason; scheduled reminders stop and your cancellation message goes out.
Both actions respect the appointment type's minimum notice: inside the cutoff, the page shows your practice phone number instead. Manage links work for staff-booked appointments too, so every reminder becomes a self-service reschedule surface — appointments owned by a connected practice management system are the exception (view-only; patients are asked to call).
Date of birth before a change
Anyone holding the link can see the booking, but rescheduling or cancelling asks for the patient's date of birth first. Once it matches, the patient has 30 minutes to make the change.
- Five wrong dates lock the link. The page then asks the patient to call you. The next reminder, or any message from you that includes the link, brings a new one.
- No date of birth on file: the patient can see the booking but not change it online. The page says "Please call" with your site's phone number. Add their date of birth to their record and the next link works.
- Rescheduling gives the new appointment its own link, which the page carries on with.
The link's secret is the part after the #, so it never reaches a web server or its logs. Each link lasts until a day after its appointment ends.
Links sent before this change (…/book/manage/?uid=…) keep working only until their appointment starts, and they ask for the date of birth before a change too.
After a patient pays a booking deposit, Stripe returns them to your booking page, which shows whether the booking is confirmed. The return address carries only Stripe's own payment reference, never a link to the booking.
Recall booking links
A recall reminder carries a one-tap link (the {{recall.bookingLink}} merge tag) that opens a short version of the booking page for that patient: no appointment type to choose and no details to type. The recall's Books online as type, its site and its clinician come pre-selected; the patient picks a time and confirms. A visit booked this way is booked straight away — it needs a type with no deposit and no practice confirmation — marks the recall booked, and sends your usual booking messages. It isn't a new enquiry: no lead is created and nothing moves on your boards. Afterwards the link shows that booking with its manage link.
Design studio
Design your own booking page with the AI assistant or your own HTML and CSS, try it with a real booking, and publish it.
Get found and booked
Put a Book button on your Google Business Profile, let AI assistants find your practice, and send patients links that open the booking page on the right location, visit and time.