Practice management

Why is this button disabled? Understanding permissions

How EnWella decides what each person on your team can do, why a button might be greyed out, and the steps to unlock it.

Updated
Updated
Reading time
5 min read
Tags
permissionsrolesaccesstroubleshootingteam

EnWella shows every action button to every teammate, but greys it out when your role does not include that action. The greyed-out button always tells you _why_ when you hover it. This article explains what those tooltips mean, why we chose this design, and the quickest path to getting the access you need.

What you see when you do not have access

A button you cannot use stays in its usual spot, but is greyed out and shows a small explanation when you hover or tap-and-hold. For example: "You must have the manage calendar permission and the appointment belongs to your current clinic." Some sensitive actions hide the button entirely instead of greying it out — these are actions where there is no useful affordance for someone who could never do them, like editing a clinical note when you are not the author.

Why we show the button instead of hiding it

Hiding buttons leads to surprise: a teammate calls you to ask "where is the cancel option?" and you cannot help them because their screen looks different from yours. By keeping every action visible, every screenshot, every training video, and every conversation between coworkers describes the same UI. The greyed-out tooltip turns "where is it?" into "I see it but I cannot use it — here is why."

Common tooltips and what they mean

You will see phrasings like "You must have the X permission" (your role does not include that action), "You must be an admin" (only practice admins can do this), "the appointment belongs to your current clinic" (you are signed into a different clinic than the record), and "you must be the patient on this chart" (a patient-portal action that only the patient themselves can take). Read the tooltip first — it tells you exactly which condition failed.

How to get the permission you need

Find the practice admin (usually your office manager or practice owner) and ask them to add the permission to your role. They open Establishment → Role access, find your row, and check the box for the permission named in your tooltip. The change takes effect the next time you reload the page — no sign-out required.

Who can grant permissions

Anyone with the Admin overlay or the manage_team permission can change your role. If your practice does not have a designated admin yet, the practice owner (the person who originally created the EnWella account) always has full access and can either grant the permission directly or promote someone else to admin.

One-time exceptions vs. a permanent role change

For a one-off task — a scribe who needs to sign a single note while the provider is on vacation — the cleanest fix is for the provider to delegate by signing afterwards on return, or for an admin to temporarily grant the permission and remove it the same day. For an ongoing responsibility, ask your admin to update your role permanently so the audit trail reflects the actual division of labour.

When the tooltip mentions "your current clinic"

If you work at more than one EnWella clinic, your roles are set per clinic. The clinic you are currently signed into is shown in the top-left corner. Switch clinics from the establishment menu — your permissions update to whatever you were granted at that location. If you genuinely have access at the right clinic but the tooltip still appears, ask the admin at that clinic to confirm your role.

For patients using the portal

Patients almost never see permission tooltips because every patient-portal action is scoped to their own record. The two places you might see one are: trying to cancel an appointment that is not yours (only the patient on the appointment can cancel), or trying to act on behalf of another household member (each person needs their own login). If you believe you should be able to do something but cannot, message your care team — they can confirm whether the action is something the clinic offers in the portal.

Frequently asked questions

Why does the button not just disappear when I cannot use it?
So that every screenshot, every training video, and every conversation between teammates describes the same screen. Hidden buttons cause "I do not see what you are talking about" confusion; greyed-out buttons with a tooltip say exactly what is missing.
I am sure I have the right role but the button is still disabled.
Three things to check: (1) reload the page — role changes apply on the next load; (2) confirm you are signed into the correct clinic if you work at more than one; (3) read the tooltip in full — sometimes the action requires two conditions (e.g. the right role and ownership of the record), and only one is missing.
Can I grant myself a permission temporarily?
No. Permission changes are always made by an admin and recorded in the audit log. This is intentional — the audit trail is the practice's defence in a HIPAA review or a chart-tampering allegation.
How do I see the full list of permissions and what each one does?
See the Role permissions explained reference article. It walks through every checkbox in the Role access screen.
Where do permission changes show up in the audit log?
Establishment → Audit → search for "role change". Each entry shows who made the change, what permission was added or removed, and which user it was applied to.