Patient app
Your practice's own app in the App Store and Google Play, for UK, US and Irish practices — what it costs, how to request it and set up your store accounts, and everything patients can do in it.
Your practice can have its own patient app, listed in the App Store and on Google Play under your practice's name, with your colour and your icon. It is published from your practice's own Apple and Google developer accounts. Smileline builds it, sends it to Apple and Google, and keeps it up to date with every Smileline release.
Patients sign in with their patient portal account. In the app they book and pay, fill in forms and sign treatment plans, message you, get reminders as notifications, and keep track of their care at home.
The patient app is for practices in the UK, the US and Ireland where Smileline runs your practice's own diary. It needs the patient portal switched on: while the portal is off, the app tells patients it isn't available.
What it costs
A one-time fee of £600 including VAT in the UK, $799 plus sales tax in the US, or €600 plus VAT in Ireland, charged to the card on your Smileline subscription when you request the app. Every update to the app after that is free.
Apple and Google charge your practice for its own developer accounts: $99 a year for the Apple Developer Program, and $25 once for Google Play.
Request your app
- Go to Settings › Website & booking › Patient app.
- Check the App name: it shows under the icon on patients' phones, 30 characters at most.
- Pick the Accent colour.
- Make the App icon: Use our logo puts the logo from Practice details on your accent colour, or Upload an image for your own square picture.
- Click Request my app.
Only the practice owner can request the app, and the fee is charged at once:
- With no card on your subscription, the page asks you to add one first: click Open Billing. On a complimentary or partner plan, contact Smileline instead — we can waive the fee.
- If the card is declined or your bank asks you to confirm, click Pay on Stripe's page. Once you've paid there, your request goes through by itself, usually within a few minutes. You can also update your card in Billing and click Request my app again. Either way you are charged once.
- If the page says your payment needs Smileline's attention, nothing more is charged while we look at it.
Need a refund? Contact Smileline: refunds are made by hand.
Set up your store accounts
Your app is listed under your practice's own name, so it lives in your practice's own Apple and Google accounts. Once you've requested it, the page lists the steps under Your store accounts. Tick Done under each store when you've finished its steps; anyone who can change settings can tick them.
App Store
- Enrol your practice in the Apple Developer Program as an organisation. You need a D-U-N-S number.
- As Account Holder, turn on API access in App Store Connect (Users and Access › Integrations).
- Invite Smileline as an Admin in App Store Connect — the page shows the address.
Google Play
- Create a Google Play developer account for your practice as an organisation.
- In Play Console, under Users and permissions, invite Smileline and Smileline's service account as admins. We email you the service account's address.
Accept Apple's updated agreements whenever App Store Connect asks: until you do, new versions of your app can't reach the App Store.
What Smileline does
Once your accounts are ready, Smileline:
- creates your app's listings in App Store Connect and Play Console — its description, screenshots, privacy answers and age rating — under your name and icon;
- sets up Apple Pay, Google Pay and notifications for your app;
- builds your app and sends the first version to Apple and Google for review;
- releases it once they approve it, and sends every later version for you.
Apple and Google decide when they approve it.
Follow its status
The page shows where your app stands:
- Requested — paid; Smileline is preparing your app. Finish your store steps so it can be submitted.
- In review — with Apple and Google for review.
- Live — in the App Store and on Google Play: share it with your patients.
- Retired — no longer offered. The app tells patients it isn't available.
While it is Requested, the owner can still change its name, colour and icon: change them and click Save. After that, ask Smileline to change them.
Updates
Every Smileline release reaches your app by itself, at the same time as every other practice's app. You don't need to do anything.
- Most updates download in the background and apply the next time the patient opens the app, so nobody is interrupted in the middle of a form.
- Now and then an update needs a new version in the App Store and on Google Play. Smileline submits it for you, and it reaches patients gradually over a few days.
- If a patient's version is too old to keep working, the app shows Update required with an Update button that opens the store.
Share your app
Once your app is live, the page shows:
- a link to its App Store and Google Play pages, each with a QR code;
- a message for SMS or email with both links — click Copy;
- Download poster, a printable poster with your app's name and the QR codes, for reception.
What patients can do
The app has five tabs:
| Tab | What it holds |
|---|---|
| Home | The next visit with a countdown, and what needs the patient: a deposit or balance to pay, forms to fill in, plans to sign, a check-up to book, today's aftercare, a review request and the tip of the day. |
| Visits | Upcoming visits, and Book a visit. |
| Care | Brushing, aligners, whitening, the smile journal, results, tips and aftercare. |
| Chat | Messages with your practice. |
| Me | Family members, documents, treatment plans, forms, payments, refer a friend, leave a review, notifications, your practice's details, security, deleting the account and signing out. |
Before signing in, anyone with the app sees your sites, opening hours and phone numbers, reads your tips, uses the brushing timer and can book a first visit (see New patients).
Signing in
Patients sign in with the email and password of their patient portal account: one account works in both the portal and the app. There is no sign-up in the app — an account always starts from you:
- Invite to portal on the patient's record emails an invitation. The patient sets their password in the browser, then signs in to the app.
- A secure link offers Sign in with email next time in the portal.
See Accounts for both.
- Sign in asks for the email, then the password, after a quick security check. With 2-step sign-in on, the app then asks for the code from the patient's authenticator app, or a backup code.
- Forgot your password? emails a link to choose a new one. Ten wrong passwords in a row pause signing in for 15 minutes, as in the portal.
- The app stays signed in for 30 days from when it was last used.
- Me › Security changes the password, turns 2-step sign-in on or off, makes new backup codes, and lists the signed-in devices, with Sign out all other devices. Sign out all devices on the patient's record signs the app out too.
- An account that holds no records shows No one to show yet and asks the patient to contact you.
Family members
A parent or guardian with portal access to a child sees everyone they look after under Me › Switch. Everything in the app — visits, booking, payments, forms, chat, care and results — is for the person chosen.
- What they can do follows the portal's rules: someone who can see a child's records but can't consent for them can't book, move or cancel visits, fill in forms, sign plans or turn on sharing.
- When their access ends — at the child's 16th birthday in the UK and Ireland or 18th in the US, or when you end the relationship — the person stays listed as Access ended and can't be opened.
- Reviews and refer-a-friend are offered only on the account holder's own record.
Visits and booking
Visits lists the patient's upcoming visits, with the time, appointment type, clinician and site. Home shows the next one with a countdown. Each visit offers:
- Confirm for a booked visit;
- Move, which opens the visit's page on your online booking inside the app, while your online booking page is on;
- Cancel visit, under your online booking's notice. Too close to the visit, the app asks the patient to call you;
- directions to the site, a button to call it, and Add to Apple Wallet or Add to Google Wallet (see Wallet passes).
These work as in the portal (see Appointments).
Book a visit
Book a visit offers what your online booking page offers. The patient picks the appointment type, the clinician (or Anyone), the site and a time, checks the visit and books. While the page is off, the app says online booking is off and asks the patient to call you.
- The visit goes straight into your diary on the patient's record, and your usual booking messages go out. It never creates or moves a lead. The activity log records who booked it — for example "Booked by Mary Jones (parent) in the patient app".
- A type you confirm first arrives as a request — the app says Request sent — with a Confirm online booking task, as from your booking page.
- A type that takes a deposit holds the time for 60 minutes while the patient pays in the app, by card, Apple Pay or Google Pay. With Pay later, they pay from Home before the hold ends; after that the time is released. While online deposits aren't available, such a type asks the patient to call you.
If the app couldn't make a booking — the time had just been taken, or something went wrong — the patient is told at once and the request waits in the review queue. Try again there books that same visit if the time is still free. Smileline never books it later by itself, because the patient may have picked another time since.
Book my check-up
When a patient's recall is due and its visit can be booked online, Home shows Your check-up is due (or Your check-up is overdue) with Book my check-up. The visit, site and clinician are chosen as for the one-tap booking link; the patient picks a time, and booking marks the recall booked.
New patients
People who aren't your patients yet can book a first visit from the welcome screen, with New patient? Book a visit, while your online booking page is on. They choose from the same appointment types, clinicians and times as on the page, give their name and an email address or mobile number, and pay any deposit on Stripe's page. At a site whose diary is your practice software, they also give what it needs to open their chart (title, date of birth, sex, address and postcode), as on your online booking page. The booking arrives as it does from your online booking page; one your practice software hasn't taken yet tells the patient you'll be in touch to confirm it. To give them the rest of the app, invite them to the portal.
Payments
Patients pay in the app with Apple Pay, Google Pay or a card, through your connected Stripe account:
- Deposits you've asked for, and the deposit of a visit they booked in the app. While a patient is paying a deposit in the app, its card payment shows as in progress on your side (see Deposit requests).
- Balance payments, while that switch is on in Settings › Website & booking › Patient portal: Me › Payments shows the account's balance, what there is to pay now, its statements and recent payments, to whoever pays the account. The same rules as in the portal apply: up to what is owed now, and one payment at a time on an account (see Balance payments).
A payment made in the app shows under Online payments on the patient's Account, and is refunded from there (see Online payments).
Forms and treatment plans
Forms lists the forms you've sent the patient that are still open. They fill them in on the phone, under the portal's rules (see Forms):
- Only someone who can consent for the patient can fill one in.
- A form that asks for a signature opens only for the person its link names, after they enter their password (and their 2-step code when it is on).
- The signature goes on when the form is sent. If 15 minutes or more have passed since they confirmed who they are, the app asks for their password again and sends the same answers. If they don't confirm, the answers wait in the review queue.
- Answers are saved as they type and come back if they leave. A form left in the background or untouched for three minutes hides itself until they carry on, and the phone's app switcher shows a cover instead of the answers.
With Online plan signing on, Treatment plans shows the plans you've presented. Review & sign works as in the portal (see Sign plans online): the patient unticks what they don't want, types their full name, signs in the box or types to sign, enters their password, ticks the statement and taps Sign and accept. The acceptance certificate then appears under Documents.
Documents
Me › Documents lists what you've shared from the patient's record with Shared documents on (see Share documents), such as letters, X-rays, photos and plan certificates. Photos open in the app. A PDF opens in the phone's own viewer, and the copy on the phone is deleted when the patient closes it. Each document opened is recorded in the activity log.
Notifications and reminders
Notifications are off until the patient turns them on, with Turn on notifications in Me › Notifications or Get reminders after booking. Each new sign-in starts with them off. They never carry adverts.
| Notification | It says (for a practice called Smile Dental) | Tapping it opens |
|---|---|---|
| Pre-visit reminder | "Smile Dental: you have an appointment coming up" | Visits |
| Recall reminder | "Smile Dental: it's time to book your check-up" | Book a visit |
| A message or aftercare from you | "New message from Smile Dental" | Chat |
| A brushing or aligner reminder the patient set | A reminder to brush, or about their trays | That tracker |
A notification opens only for an account signed in on that phone, and switches to the person it is about. After signing out, a notification opens nothing.
Reminders instead of texts
When a patient has your app with notifications on, Pre-visit reminders and recall reminders go to the app as a notification instead of their text, WhatsApp or email. Parents and guardians with the app and notifications on get them too.
- A notification goes only inside your sending hours, as your texts do.
- If no phone confirms it got the notification, the reminder goes by its usual channel instead, usually within 45 minutes. When Smileline can't tell whether it arrived, the reminder goes by its usual channel as well: now and then a patient may get both, never neither.
- The other booking messages go by their usual channels.
See Booking messages and Recall reminders.
Messages in the app
Patients, and the parents or guardians who look after them, can write to you from the app's Chat tab and send photos; your replies reach them there.
- Go to Settings › Website & booking › Patient app.
- Turn on Messages in the app.
Anyone who can change settings switches it.
Messages arrive in the inbox on the patient's own thread, on the App channel — always the patient they are about, never matched by phone or email — signed with who wrote them, for example "Sarah · parent · app" when a parent writes about their child. Reply from the inbox as usual, with up to four photos or PDFs if you need them; there is no time limit on replies. The patient gets a notification that only says New message from your practice, and reads your reply in the app.
To start a chat yourself, open the patient's thread (or the Chat tab on Leads) and pick App in the channel menu. It lists each of the patient's app accounts that is signed in — the patient's own, and a parent's or guardian's.
- A reply to someone whose access to the patient has ended (a parent once the child is old enough, a relationship you ended) isn't sent: it shows Not sent in the thread, and nothing reaches the app.
- AI replies, message triage and campaigns don't use the App channel.
- The chat tells patients it isn't for emergencies and shows your phone number.
- A message or photo from the app that can't be added to the thread — for example one sent after the person's access ended — is kept for you in the review queue, never thrown away.
With Messages in the app off, the app's Chat says you don't take messages in the app and asks patients to call you, a reply typed in the inbox on App isn't sent, and aftercare goes by its usual channel. Messages already sent stay in your inbox.
Aftercare
Aftercare is a Post-visit follow-up booking message set for a treatment (see Messages for one treatment). When the patient has your app with notifications on and Messages in the app is on, it arrives in the app as a message from your template's text, with a notification, instead of by its usual channel. When the patient has no app account of their own, a parent's or guardian's app gets it.
Under Care › Aftercare, the app gathers the aftercare messages the patient was sent there, newest first, each titled with its template's name. The app never writes aftercare of its own: edit the wording in Settings › Messaging › Templates.
Tips
Smileline's oral-care tips appear in your app, on Home as the tip of the day and under Care › Tips. Patients see them even before they sign in. In Tips in the app, on the Patient app settings page, you can:
- reword a tip — it shows Edited, and Reset brings back Smileline's text;
- Hide one of Smileline's tips, and Show it again;
- Add a tip of your own (up to 100), and Remove it;
- change the order with the arrows.
Click Save tips to save the list. Anyone who can change settings can edit the tips. When Smileline improves one of its tips, your app shows the new text — unless you reworded it.
Care at home
Under Care, patients look after their care at home:
- Brushing: a two-minute timer that guides them round each quarter of the mouth, morning and evening reminders, a streak and a weekly chart. On an iPhone they can save each brushing to Apple Health.
- Aligners: their tray plan from your instructions, Aligners out and Aligners back in as they take them out and put them back, the hours worn each day against a 22-hour goal, and reminders on the day a new tray is due and after 30 minutes out.
- Whitening: each night's wear and how sensitive their teeth felt. Strong sensitivity suggests a night off and a message to you.
- Smile journal: guided photos of the same poses (front, sides, top and bottom teeth, smile) to compare over time.
It all stays on their phone until they choose to share it with you. Reminders they set show only your practice's name, never their treatment.
Sharing with your practice
The patient turns on sharing in the app, after a notice that what they share becomes part of their dental record. Only someone who can consent for the patient can turn it on; anyone using the app for that record can turn it off.
- While sharing is on, brushing, aligner wear and whitening nights reach you as they are logged. Entries logged offline arrive once the phone is back online.
- A smile-journal photo goes only when the patient shares it.
- Turning sharing off stops anything new reaching you. Nothing already shared is removed: it stays in the patient's record.
- Brushing timed before anyone signed in stays on that phone until someone signed in adds it to the record they choose, or deletes it — it never joins whoever signs in next on a shared phone.
Turning sharing on or off is recorded in the activity log.
Smile-journal photos
Each photo the patient shares is filed on their record as a clinical photo on the Files tab, titled Smile journal with its pose and dated the day it was taken. It is kept like any clinical photo. The same photo sent twice is filed once. Deleting it from the phone doesn't remove the shared copy.
A file that isn't a JPEG, PNG or WebP photo is never filed, and neither is one that arrives after sharing was turned off or the person's access ended. It waits in the review queue, once however often the app sends it again: Try again files it once it may be filed (sharing back on, for example); otherwise mark it as handled, or delete it. Brushing, aligner and whitening entries you can't accept wait there the same way.
The Home care card
What a patient's app has shared shows at the top of their Clinical notes panel, in the Home care card, for anyone who can read the patient's documents. Nothing shows for a patient who hasn't shared anything. The card is one slim row — the aligner tray, the brushing streak and when they last brushed — until Show opens the rest:
- Aligners: the tray they are wearing, for example Tray 5 of 20, day 9, and the day the next tray is due — or, once the change is overdue, the day it was due. Below, a bar for each of the last 14 days shows the hours worn against the 22-hour goal (the dashed line). A day the app didn't track is an empty outline; hover over a bar for its hours.
- Brushing: how many days in a row they have brushed, when they last brushed, and how many sessions in the last 14 days.
- Whitening: how many nights they have logged, and how sensitive their teeth felt on the latest one.
- Smile journal: the shared photos, newest first. Click one to see it larger, and choose another under Compare with… to see the two side by side, the older on the left.
Days follow your practice's time zone. For a patient who has logged a great deal, the card counts the most recent entries and says Older entries aren't counted. Each time the card opens, the look is recorded in the activity log.
Results
Turn on Results in the app in Settings › Website & booking › Patient portal (it shows while the portal is on). Patients then see, under Care › Results:
- Your treatment: each accepted, in-progress or completed treatment plan, with how many of its treatments are done and the next one. This is automatic.
- Gum health: only the BPE, PSR and probing exams a clinician shares with Share with patient on the record's Perio tab (see Share with the patient). Each shows its date, its sextant codes or its bleeding and plaque figures, what they mean in plain words, and the exam's Notes under From your clinician — so write the notes for the patient. Stop sharing takes the exam out of the app at once.
- X-rays and photos you have shared with the patient (see Share documents).
While Results in the app is off, the app says your practice hasn't switched results on. Each look at Results is recorded in the activity log.
Reviews and refer-a-friend
- Leave a review: when you have sent an adult patient a review request they haven't answered and that hasn't expired, the app offers it on their own record. It opens the newest request's page, with the same two choices as the message (see The patient experience). A parent never sees it on a child's record.
- Refer a friend: while your referral programme is on, patients get their own refer-a-friend link and code in the app, on their own record, to share from their phone. Getting it enrols them in your programme, as enrolling them from their record does; a friend who books through it arrives as a lead. The app doesn't show rewards.
Wallet passes
Patients can add an upcoming visit to Apple Wallet on an iPhone or Google Wallet on Android. The pass shows your practice's name, "Dental appointment", the time, and the site's address and phone number — never the treatment. Adding it again after the visit moves updates the same pass.
Wallet passes rely on Smileline's own Apple and Google Wallet set-up: until it is in place, the app says passes aren't available yet. Each pass added is recorded in the activity log.
iPhone widgets
On an iPhone, patients can add the Next visit widget to their home screen or lock screen. It shows your practice's name, the day and time of the next visit of the person they're looking at in the app, and a live countdown — never the treatment, the clinician or the site. On the day of the visit, once the patient opens the app, the countdown also shows on their lock screen until the visit is over.
Widgets are for iPhone only. On Android, patients can save the visit to Google Wallet instead.
Deleting an account
A patient, or a parent or guardian, deletes their own account in the app: Me › Delete account, then Delete my account, with their password (and their 2-step code when it is on).
- Only that account goes, in the app and the portal alike: its password, its 2-step settings, every device it was signed in on and its access to the records it held.
- The dental records stay with you, as do the forms and plans it signed and the messages already in your inbox. Anyone else's access to the same records doesn't change. To erase a patient's records, see Erasing a patient.
- Anything its app sent that wasn't filed yet — a message, a photo, care entries, a booking — waits for you in the review queue. Try again on a message adds it to the patient's thread. Erasing the patient deletes it too.
Your store listings link to a page on your portal's address that explains how to delete an account: in the app, or by asking you. For a patient who asks you instead, open Details › Patient portal on their record and click Delete account on theirs (twice to confirm; Smileline may ask for your own password): it goes exactly as above, even if it was disabled.
When something needs you
Everything the app sends is stored before Smileline reads it. When something can't be used straight away, it waits in Settings → Review queue for owners and managers instead of being lost:
- a message or photo sent after the person's access ended, or one Smileline couldn't read;
- care entries that couldn't be read or arrived after sharing was turned off;
- a smile-journal photo that couldn't be filed;
- a booking the app couldn't make;
- a signed form whose signer's confirmation had lapsed;
- anything sent by an account that was deleted before it was filed.
See Patient app items for what to do with each.
Privacy
- Your practice is the data controller for your patients' information in the app, as it is in the portal; Smileline processes it on your behalf.
- Notifications name only your practice. Wallet passes and the iPhone widget show the visit's time and your practice, never the treatment.
- Care tracking stays on the patient's phone until they choose to share it, and they are told first that what they share becomes part of their dental record.
- Smile-journal photos stay inside the app, not in the phone's photo library, and leave the phone when the patient signs out. Signing out also clears the app's notifications.
- Forms hide themselves after three minutes in the background or untouched.
- What patients and parents do in the app is recorded in the activity log, as the person who did it, as in the portal.
Patient portal
Let patients and parents open their records online with a secure link and a date of birth, or with their own account, to confirm or change appointments, fill in forms, pay deposits and balances, download shared documents and sign treatment plans.
Account and payments
The patient's ledger on the clinical record — charges, payments (cash, card or on a card reader), refunds, adjustments, reversals, invoices, credit notes and family accounts; the till and period close are on Payments.