Prerequisite: Tipping must be turned on for your clinic. If tips don’t appear at checkout, switch on Collect tips under Settings → Billing → Payment Management → Tips.To ask about each provider separately, also switch on Provider-specific tipping. Suggested percentages will then use only the items attributed to that provider.
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.1
Open Payment Management settings
Navigate to Settings → Billing → Payment Management and scroll down to the Tip Displays section.
2
Add a new display
Click Add Tip Display to open the setup dialog.
3
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.
4
Save
Click Add Display. The display will now appear in the Tip Displays list and can be activated from any device.
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.1
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.
Cmd+K, type “tip”, and choose Copy Tip Screen Link. That puts the address on your clipboard so you can send it to the tablet.You need to be signed into the platform on this device. If prompted, log in before continuing.
2
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.
3
Select the display
You’ll see a list of tip displays registered for that location. Tap the one that matches this device.
4
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).1
Open checkout and select the patient
Navigate to Billing → Checkout and select the patient as usual.
2
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.
3
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.
4
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.
5
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.
6
Customer selects a tip
When Provider-specific tipping is on, the display asks about each provider one at a time. For each provider, the customer sees that provider’s items and chooses a percentage, a custom amount, or No Tip. Percentage options use only that provider’s attributed items, not the full checkout total.After the last provider, each tip is assigned automatically to the correct provider. Continue to payment as normal.If the customer chose no tip, no window appears and you can proceed straight to payment.Closing the window with Discard Tip drops the tip — the customer’s selection is not applied. Use this if the patient changes their mind or you need to redo the tip prompt.If you need to cancel the tip request before the customer selects, click Cancel Request in the checkout bar.
Choose Who Can Receive Tips
Staff are eligible for tips by default. To take someone out of the list — a manager who never receives them, or a departed provider — open Settings > Staff > Users, edit the user, and clear Can receive tips. To change several people at once, select them in the users table and use the Tips tab of the bulk edit drawer. Someone who can’t receive tips is never offered as a recipient at checkout or on the patient tip screen. Tips already recorded for them are unaffected.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.
A provider is missing from the tip recipients
A provider is missing from the tip recipients
Their user record has Can receive tips turned off. Turn it back on under Settings > Staff > Users. If no one is offered at all, the ticket has nothing tippable on it, or no staff member is set up to receive tips.
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.

