Restricting Staff to Specific Patients
Last updated: October 20, 2026
Patient groups let you limit which patients a staff member can see. For example, Provider A can see only the patients in Group A, and cannot find or open the charts of patients in Group B who belong to Provider B. This article walks through setting that up and testing it before you roll it out.
How it works
Two kinds of permissions work together, and a restricted user needs both:
Patient groups control which patients a user can see.
Model permission groups (such as Clinical read and Profile write) control what a user can do, such as opening charts, searching, and scheduling.
If you assign only a patient group, the user will not be able to open any charts, including the charts of their own patients. Always assign the model permission groups the user needs for their job as well.
Every instance also has an All Patients group. Anyone who has it can see every patient, so it must be removed from anyone you want to restrict.
See User Permissions for a full description of each model permission group and how restricted access appears to users.
Before you start
Patient permissions must be turned on for your instance. Contact your Canvas team to confirm this before you begin.
You need access to Settings with the Staff Permissions Access group to manage patient groups and staff permissions.
Step 1: Create patient groups
Go to Settings > Practice: Patient groups.
Create one patient group for each provider or team whose patients should be kept separate.
Check Use for permissions on each group. Without this, the group exists but does not restrict anything.
Add the right patients to each group. A patient can belong to more than one group if more than one provider or team needs access.
See Patient Groups for adding members manually or keeping membership up to date automatically.
Step 2: Assign groups to staff
Go to Settings > Practice: Staff Permissions, select the staff member, and update their groups.
For a restricted user, add:
Their patient group (for example, "Provider A Patients")
The model permission groups they need to do their work. A typical clinical user needs:
Clinical read
Clinical write
Profile read
Profile write
Document Read
Document Write
Schedule write
Printing Access
Make sure the restricted user does not have the All Patients group.
For staff who need every patient (for example, front desk, billing, or administrators), keep the All Patients group in place.
A role's default groups are the same for everyone with that role, and they only apply when someone is first given the role. Assign each person's patient group individually under Staff Permissions.
Step 3: Test before rolling out
Test with two staff accounts: one restricted user and one control user who has All Patients. Pick one patient who is in the restricted user's group and one who is not.
Restricted user
Test | Expected result |
|---|---|
Log in | Reaches the Canvas home page |
Search for a patient in their group | The patient appears in results |
Search for a patient not in their group | The patient does not appear in results |
Open the chart URL of a patient not in their group | The chart does not load, and the user sees "You do not have permission to view this data" |
Open the chart URL of a patient in their group | The chart loads normally |
Control user
Test | Expected result |
|---|---|
Search for the patient who was hidden from the restricted user | The patient appears in results |
Open that patient's chart URL | The chart loads normally |
The control user confirms that the patient and chart exist, so a hidden result for the restricted user reflects the permission rather than a missing record.
Things to know
"See all patients" in search. By default, a restricted user who clicks "See all patients" at the bottom of search results can see the names of patients outside their group, but cannot open their charts. This lets staff check whether a patient already exists before creating a duplicate. If your organization prefers that restricted users never see those names, contact your Canvas team. With that option on, staff cannot tell that a patient already has a chart elsewhere in your instance, so plan for how new patients are created and how duplicates are caught.
Assigned items. Items assigned to a user for a patient they cannot access, such as new lab results, will not be visible to them. Make sure each user's group includes every patient whose items are routed to them.
Keeping groups current. Patient group membership does not follow care team changes on its own. Update membership manually, or keep it in sync automatically as described in Patient Groups.
Troubleshooting
Symptom | Likely cause | Fix |
|---|---|---|
Restricted user cannot open any charts, even their own patients | No model permission groups assigned | Add Clinical read/write, Profile read/write, Document Read/Write, and the other groups the user needs |
Restricted user can see every patient | The user still has the All Patients group | Remove All Patients from the user under Staff Permissions |
A patient group does not restrict anything | Use for permissions is not checked on the group | Edit the patient group and check Use for permissions |
Restrictions do not apply to anyone | Patient permissions are not turned on for your instance | Contact your Canvas team |
Related Resources
Patient Groups - Create patient groups and manage their membership
User Permissions - Model permission groups and how object permissions affect users
Managing Patient Care Teams - Assign care team members to a patient