Prerequisite: Tipping must be turned on for your clinic. If tips don’t appear at checkout, switch on Collect tips under Settings → Payment Management → Tips.
Part 1: Register a Tip Display
Before using the tip screen, an admin needs to register the display in settings. This only needs to be done once per device.Open Payment Management settings
Navigate to Settings → Payment Management and scroll down to the Tip Displays section.
Name your display and select a location
Give it a descriptive name (e.g. “Front Desk”, “Checkout 1”) and select the location it belongs to. The location is important — the display will only appear as an option during checkout when that same location is selected.
The location cannot be changed after creation. If you need to move a display to a different location, delete it and create a new one.
Part 2: Set Up the Display Device
This is done on the device that will face the customer — typically an iPad or secondary monitor. The device needs to be logged into the platform.Navigate to the tip screen
There are two ways to open the tip screen on the device:
- Quick search: Press
Cmd+K(orCtrl+Kon Windows) to open the search, then type “screen” or “tip screen” and select the result. - Direct URL: Go to
/{your-tenant}/tip-screenin the browser.
You need to be signed into the platform on this device. If prompted, log in before continuing.
Select a location
If the device doesn’t have a default location set, you’ll be prompted to pick one first. Select the location this display is assigned to.
Select the display
You’ll see a list of tip displays registered for that location. Tap the one that matches this device.
Confirm the display is ready
The screen will show a standby state with the display’s name and a Ready indicator. It will read “Waiting for checkout to connect” — this means everything is set up correctly and the display is waiting for a staff member to connect from the checkout page.A Change Display button is available at the bottom if you need to switch to a different display.
Part 3: Collect a Tip at Checkout
Once the display device is set up and showing the standby screen, follow these steps on the checkout terminal (staff-facing device).Open checkout and select the patient
Navigate to Billing → Checkout and select the patient as usual.
Select the correct location
This step is critical — the location selected on the checkout must match the location of the tip display you want to use. If they don’t match, the display won’t appear as an available option.
Connect to the customer display
Once a location is selected, a Connect Customer Display button will appear in the checkout sidebar. Click it to open the display picker.A dialog will show the available displays for that location with their status:
- Ready to connect (green) — the display device is online and available
- Display not active (gray) — the display device hasn’t opened the tip screen yet
- In use by another checkout (yellow) — another checkout terminal is already connected
If you’ve used a display from this checkout before, it reconnects automatically when the page loads — as long as it’s still online and not in use by another checkout. You only need to open the picker when the auto-connect is skipped or you want to switch displays.
Build the charge
With the display connected, the checkout sidebar will show a Live badge — the customer can now see the running order total and line items on their screen in real time as you add items.Add all products and services to the charge before requesting a tip, since the total shown to the customer will update as you build the order.
Request a tip
Once the charge is complete and you’re ready to collect a tip, click Request Tip in the connected display bar.The display will show the customer tip options — 15%, 18%, and 20% — along with a no-tip option. The checkout bar will change to show a Waiting for tip indicator.
Customer selects a tip
The customer taps their preferred tip amount on the display. What happens next depends on how many providers saw the patient that day:
- One provider: A Tip Recipient window opens on the checkout screen with that provider already selected. Confirm and the tip is added to the charge.
- Two or more providers: The display shows a split bar after the customer picks a total. The customer divides the tip across the providers themselves — dragging the dividers or using the plus/minus buttons — then confirms. Each provider’s share is recorded automatically, so the Tip Recipient window is skipped on the checkout screen.
Troubleshooting
The display shows 'Display not active'
The display shows 'Display not active'
The display device hasn’t opened the tip screen yet, or the page wasn’t loaded. On the customer-facing device, open the tip screen and confirm it shows the standby “Ready” state before trying to connect from checkout.
The display shows 'In use by another checkout'
The display shows 'In use by another checkout'
Another checkout terminal is already connected to this display. That connection needs to be disconnected before you can take over. Either disconnect from the other terminal, or select a different available display.
The display device shows 'Display active on another device'
The display device shows 'Display active on another device'
This means another device has already activated this display as a tip screen (opened the tip-screen page and selected this display). Only one device can act as the display at a time. Close the tip screen on the other device, then reconnect by tapping Reconnect on this device.
The 'Connect Customer Display' button isn't showing
The 'Connect Customer Display' button isn't showing
The display isn't showing for the right location
The display isn't showing for the right location
Displays are tied to a specific location. Double-check that the location selected in checkout matches the location assigned to the display in settings. If they don’t match, the display won’t appear.
