Patient profile
The patient record that opens over any page: nine tabs, a staff comments rail, and every action you can take on one patient.
The patient profile is the record your team lives in — nine tabs covering everything you know about one patient, plus a staff-only comments rail, opened as a window over whichever page you were on.
Questions people ask about this page
What is the address of a patient's page?
There isn't one in the usual sense. The profile is a window, not a page: there is no /patients/{id} route. It opens by adding ?patient=<patient id> to whatever page you are on, and you can jump straight to a tab with ?patient=<id>&patient_tab=labs. Copying the address bar while the window is open gives a colleague a working link.
Why am I asked to acknowledge Protected Health Information before I can read a form?
Because the form belongs to someone else. A Client Admin or Client Staff opens their own client's forms straight away; the dialog Viewing Protected Health Information only appears when the submission is owned by your provider network (or another tenant). It has two paragraphs and a Cancel / Continue pair. It is not a bug and it is not a permission error — click Continue. Providers and Super Admins never see it at all. Your acknowledgement is written to your client's form review log either way.
Which tab has the thing I want?
Profile for contact details and clinical background. Forms for intake and consents. Visits to book or reschedule. Orders for purchases. Prescriptions for medications and pharmacy status. Labs for results and lab orders. Documents for uploads and notes. Messages for the patient thread. Activity for the audit trail.
What is the Comments rail, and can the patient see it?
It is a staff-only notes column that stays visible next to every tab. The patient never sees it — the tooltip says so: "Staff only — the patient never sees these comments." But the Shared visibility does expose a note to your provider network. Use Internal for anything commercial.
The patient cannot sign in. What do I do from here?
Open Patient actions (the kebab in the header) and choose Send Magic Link — it emails a one-tap sign-in link. Copy Magic Link puts the same link on your clipboard for a live chat. Treat that link like a password: anyone holding it is signed in as the patient.
Deactivate or Archive — which one?
Deactivate (in Patient actions) switches the account off and can be undone with Activate. Archiving hides them from the working list and is done from the Patients row menu, not from here. Neither deletes anything. Only a Super Admin can delete a patient.
Where are Chart Reviews?
Not here. A Chart Reviews tab exists in the code but is switched off for everyone, so nine tabs is the real number. Clinical review lives with the provider network. If a link tries to open that tab, you land on Visits instead.
Can I export what I am looking at?
Yes. Six tabs carry their own Export CSV button — Forms, Visits, Orders, Prescriptions, Labs and Documents. Profile, Messages and Activity have none. Each export covers only the columns on screen — form answers are never exported — and every one is audited: who exported which tab, how many rows, and when. The filename uses the patient id, never their name.
Where to find it
Left menu → Patients, then click the patient's row. It also opens from the row menu's View / Edit, from a patient row on Visits, from the patient's name in a Messages thread, and from anywhere the address carries ?patient=<id>. Visible to: Client Admin and Client Staff, with the same nine tabs.
The window's screen-reader title is the patient's name, described as View and manage patient profile, appointments, assessments, and more. Close it with Close dialog.
What is on this page
The header
| What you see | What it does |
|---|---|
| Name, email, phone, DOB | Each is click-to-copy — the controls read Copy Name, Copy Email, Copy Phone and Copy Date of birth. A toast confirms. |
| Status badge | Active, Archived, Deceased or Unknown. |
| Client and state badges | Which client owns the record, and the patient's state. |
| Call pill | Tooltip Call {name}. Only appears when your client's messaging phone number is live and the patient has a phone on file. |
| Request product approval | Asks a provider to review products for this patient. No order, payment or prescription is created. |
| Edit profile picture | Client Admin only. Upload picture / Change picture / Remove picture, then a Crop profile picture dialog. |
| Patient actions kebab | Activate / Deactivate · Send Magic Link · Copy Magic Link · Login as User. |
| Close dialog | Returns you to the page underneath. |
The nine tabs
| Tab | What lives in it | What you can do from it |
|---|---|---|
| Profile | Cards Profile Overview, Allergies, Current medications, Surgical history, Prior medical conditions, Weight journey, plus Custom fields when your client has any. | Edit any field directly — changes save as you type. No Save button. |
| Forms | Forms (what they submitted) and, when something is outstanding, Pending Form Requests. With nothing outstanding the second card is not rendered at all. | Request Form to ask for more. View an answer set after the PHI acknowledgement. Cancel a request you no longer need. |
| Visits | Every past and upcoming appointment. | Schedule a new one. Per row: Open visit, Reschedule, Resend scheduling email, Cancel visit. |
| Orders | Columns Date, Product, Pharmacy, Type, Amount, Status, Order #. | Read-only here. Act on orders from the Orders page. |
| Prescriptions | Columns Prescribed, Medication, Provider, Pharmacy, Status, Last Updated. | View details opens the same dialog as the Prescriptions page, including Start refill. |
| Labs | Sub-tabs Lab Results and Lab Orders, each with counts. | Request Lab, Upload Lab, or drag a PDF onto the tab — the overlay reads Drop file to upload lab result. |
| Documents | Columns Uploaded, Name, Type. | Add Note, Upload, then per row View, download or Delete. CCDA Export is present but permanently disabled. |
| Messages | The secure thread with this patient. | Start Conversation if there is none yet, then write in place without leaving the record. |
| Activity | Heading Patient activity, filtered by Care & operations, Navigation, Interactions, System. | Search and read. This is the per-patient audit trail. |
| Comments rail | Always docked beside the tabs, never a tab of its own. | Post a staff note as Internal or Shared, with AI rewrite tools. |
How to correct a patient's details
Open the record
Left menu → Patients, click the row. It opens on Profile.
Edit in place
The card Profile Overview holds First Name *, Last Name *, Email *, Phone, Date of Birth, Sex Assigned at Birth, Language preference, Client, Status, Last provider and Mailing address. Type into a field and it saves itself — an indicator beside the label shows the save.
Add clinical background
Allergies is a comma-separated list (placeholder e.g., Penicillin, Peanuts). Current medications takes a name and a dose per row (placeholders e.g., Metformin and e.g., 10 mg daily) — click Add medication for another. Surgical history and Prior medical conditions work the same way, a name and a year per row (e.g., Appendectomy, e.g., 2019), with Add another procedure and Add another condition.
Record weight, if the programme needs it
Weight journey takes Current Weight, Peak Weight, Goal Weight, Lowest Adult Weight and Height in feet and inches, and draws a Progress to Goal bar.
Leave Custom fields alone
If the Custom fields card is present it says "Partner data from the Client API. Read-only here — update via PATCH." It only renders when your client has custom fields turned on and at least one value.
How to read a submitted form
Open the Forms tab
The card Forms lists what the patient submitted, with the count in its description.
Find it
Search with Search forms..., or narrow with All categories → Intake or Consent.
Click View
If your own client owns the form, the answers open immediately. If your provider network owns it, the dialog Viewing Protected Health Information comes first. It asks you to acknowledge that you are authorised to view the record for care coordination, and that your access is recorded in your organisation's audit logs.
Click Continue
The answers render in a Submitted form viewer. Cancel backs out without opening anything.
The acknowledgement is per view, not per session, so expect it again on the next network-owned form. Providers and Super Admins skip it entirely, and so do you on your own client's forms — that is why two people can disagree about whether this dialog exists.
How to request forms from a patient
Start the wizard
On the Forms tab, click Request Form. The four-step wizard Request Patient Forms opens — Choose product approval or individual forms, then select items from the table.
Step 1, Select items
Answer Why are you requesting forms from this patient? — Product approval pulls in the intake and consent forms attached to each product you pick. Individual forms lets you request named forms with no product attached. Then tick items in the Products or Forms table.
Step 2, Visit preference
Ask patient to book a visit after forms? — No (forms only), Yes — async review is okay, or Yes — live visit requested.
Step 3, Visit type
Only when you asked for a live visit. Pick which visit the patient should book, and answer Do you want to charge the patient for this visit?
Step 4, Past forms
Only in product mode. Should the patient complete forms they already submitted in the past? — Yes asks again, No only requests what is missing.
Send it
Click Send Request, then confirm on Send form request?. A toast reads Form request sent to patient and the request appears under Pending Form Requests.
How to book or move a visit
Open the Visits tab and click Schedule
The modal Create Visit opens — Select the patient, choose how scheduling should happen, and create the visit.
Choose the mode
Ask Patient to Schedule creates a pending visit and lets the patient pick a slot. Book Visit for Patient takes a provider slot now and creates a confirmed visit.
Fill the details
Provider, Visit type, whether it is tied to an order, Notes (optional), and Do you want to charge the patient for this visit?
Create it
Click Create Visit (or Create Request when you asked the patient to schedule).
Move an existing one
On the row, choose Reschedule. The modal becomes Edit Visit Schedule and tells you what survives: "Existing order, invoice, charge, and chart links stay attached to this visit."
If the patient never got the email
Choose Resend scheduling email on the row before you assume something is broken.
Cancelling
Cancel visit is Client Admin only. It opens Cancel Visit with an optional reason.
How to handle labs and documents
Request a lab
On the Labs tab, click Request Lab. Choose Request purchase (The patient pays for this lab to continue.) or Request lab (The patient pays, or uploads a recent result for you to review.), then pick the Lab and the Consultation to start, and click Send Request.
Upload a result you were sent
Click Upload Lab, or drag the file onto the tab and drop it on Drop file to upload lab result.
Add a clinical note
On Documents, click Add Note. Choose a Document Type — Chart Note, Short Note, Short Document or MSO Consultation Notes — add a Title (optional) and write the body.
Upload a file
Click Upload. Drag and drop one or more image or PDF files, then confirm a document name for each. Each file needs a name and a type: General Document, Patient ID Front or Patient ID Back.
Deleting is permanent
Delete document? warns "{name} will be permanently removed. This action cannot be undone."
How to leave a note for whoever picks this patient up next
Use the Comments rail
It is already open beside the tabs, headed Comments.
Write the note
Click into Add a staff comment… Maximum 4,000 characters.
Choose the audience — this is the part people get wrong
Set Who can see this comment: Internal means Client users only. Shared means Shared with the provider network. Commercial notes belong on Internal.
Or speak it
Start comment dictation types what you say straight into the box. Read it back before posting.
Tidy it up, optionally
Open AI tools and pick Make concise, Improve clarity or Professional tone. It rewrites your draft only — "Review before posting."
Post it
Click Post comment, then check the badge on the posted note. A green Shared badge means the provider network can read it. Use Edit or Delete if you picked the wrong audience.
Statuses you will see here
| Status | Where | What it means | What to do |
|---|---|---|---|
| Active | Header badge | Normal account. | Nothing. |
| Pending | Profile → Status field | Invited or created, not yet approved. | Send a magic link so they finish setting up. |
| Archived | Header badge | Hidden from the working patient list. | Set Status back to Active on the Profile tab. |
| Deceased | Header badge | Set by hand. | Nothing. |
| Unknown | Header badge | The status field is empty, usually on an imported record. | Set a status on the Profile tab. |
| Scheduled · Confirmed · Pending review · Pending scheduling · Checked In · Completed · Deferred · Denied · No Show · Cancelled | Visits tab filter | The visit lifecycle. | Pending scheduling means the patient still has to pick a slot — resend the email. |
| Unpaid · Pending Review · Under Review · Approved · Purchase Complete · Denied · Deferred · Sent to Lab · Results Received | Orders tab filter | A short slice of the order vocabulary. | Act on the Orders page — this tab is read-only. |
| Internal / Shared | Comments rail | Who can read the note. | Edit the comment to change it. |
| Patient / You | Labs tab, Source column | The result was uploaded by hand rather than arriving from a lab. | Treat uploaded results with more care than connector results. |
Prescription statuses on this tab use the same vocabulary as the Prescriptions page — see Prescriptions and refills.
What can go wrong
| What you see | Why | Fix |
|---|---|---|
| Viewing Protected Health Information blocks a form | Expected. Every client role attests before form answers render. | Click Continue. Your access is logged. |
| You do not have access to this patient | The patient belongs to a different client. | Nothing you can change. Patients are scoped to one client. |
| User is not a patient | The ?patient= value points at a staff account. | Staff records open with ?user= instead, from Messages. |
| No phone icon in the header | The patient has no phone number, or your client's messaging number is not live. | Add the phone on Profile, and check the phone number under Integrations. |
| No Edit profile picture control | You are Client Staff. Photo editing is Client Admin only. | Ask a Client Admin. Every other action is identical for both roles. |
| CCDA Export does nothing | The button is rendered permanently disabled. | Use the per-tab CSV export, or ask support for a record export. |
| No Pending Form Requests card on the Forms tab | Nothing is outstanding, so the card is not rendered. | Nothing. Use Request Form if you need to ask for something. |
| No Delete Patient in Patient actions | Deleting a patient is a Super Admin action. A Client Admin and a Client Staff both see only Activate/Deactivate, Send Magic Link, Copy Magic Link and Login as User. | Deactivate or archive instead. Ask support if a record genuinely has to be destroyed. |
| A form opens with no acknowledgement for you, but a colleague gets the dialog | The acknowledgement follows who owns the submission, not who you are. Your own client's forms open straight away; your provider network's do not. | Nothing. Both behaviours are correct. |
| Editing a field appears to do nothing | Fields save themselves; there is no Save button. | Watch the indicator beside the field label, then reopen the record to confirm. |
| A No Show filter on Visits returns nothing, ever | Nothing in the system writes No Show to a GEN visit. A provider no-show is recorded on a separate field while the visit stays Confirmed. | Do not use it as a report. Look at Cancelled and Completed instead. |
| A colleague sees different words on the same patient's status | Client roles read the raw account status (Active / Pending / Deactive / Archived). Providers read a derived one (Account Setup Required / Forms Required / Sync Visit Required). | Say which status you mean when you compare notes with a provider. |
Next
Was this helpful?
