Provider Manual · Part IV

Practice setup — practice & people

Set up the organization and the people in it: practice info, physicians, staff and assistants, patient registration, patient-portal branding, and how everyone signs in and stays signed in.

18 sections~46 min read7 screenshots
IV
Part IV

Practice setup — practice & people

Set up the organization and the people in it: practice info, physicians, staff and assistants, patient registration, patient-portal branding, and how everyone signs in and stays signed in.

4.1Practice info

Set the practice record, locations, and accepted insurance

Practice Info is the organization's identity card. Org admins fill it in once; every downstream feature — claim submission, fax cover sheets, patient portal headers, online-booking landing pages — reads from this record. There is no per-physician override here; everything is at the organization level.

  1. Open Admin > Practice Info. The modal opens to the Overview tab under the Practice section.
  2. Check and correct the Organization Details. Click the pencil on the Organization Details card to edit the record in place: name, type (Hospital, Group practice, Solo practice, Clinic, Laboratory), street address, city, state, ZIP, phone, fax, and email. Click Save Organization when you're done, or Cancel to discard. These values flow into claims, fax cover sheets, and portal headers, so re-check them after a move or a rebrand. The organization timezone is shown on the same card but is deliberately not editable here — change it from Scheduling settings so appointment and reminder times are recalculated safely.
  3. Add Custom Info (optional). The Custom Info tab stores free-text fields shown to admins for reference — Inquiry Hero context, internal notes, third-party account numbers.
  4. Review Providers under the Records section. Lists every physician attached to the org. To add or edit them, use Physician Management — Practice Info is read-only here.
  5. Add practice Locations. Each physical address you see patients at. Locations also appear inside Scheduling > Locations when physicians assign themselves to a site.
  6. List Accepted Insurance. The plans your practice is in-network with. Used by online booking, intake, and the eligibility tools — patients see the list when picking a payer at booking.
Admin · Practice Info modal showing the Overview tab with Organization Details including name, type, address, phone, fax, email, and timezone
Organization Details is editable in place from the pencil. Use the left rail to switch between Overview, Custom Info, Providers, Locations, and Insurance.
Order of operations: Set Practice Info before Physician Management. Locations created here become selectable when you set each physician's weekly schedule.
4.1aDiagnosis names

Rename a diagnosis: show your practice’s own name for an ICD-10 code

Admin → Diagnosis names lets the practice show its own wording for an ICD-10-CM code (for example Gender dysphoria instead of the official title) in diagnosis pickers and the problem list. Claims keep the code, and staff can still see the official title.

  1. Open Admin → Diagnosis names. Practice administrators, the owner and staff who manage templates can open it.
  2. Under Name a diagnosis, search ICD-10-CM by code or words, e.g. F64.0, and pick the code. Its official title shows as ICD-10-CM: ….
  3. Type your practice’s name and click Save name.
  4. Change or remove names under Your practice’s names: the pencil edits a name (Save or Cancel); removing one brings back the official title.

In the diagnosis search and typeahead, a renamed diagnosis shows your name with the official title under it; tooltips on Current Diagnoses and diagnosis chips show the official title too. Until you add a name, every diagnosis shows its ICD-10-CM title.

4.1bInsurance we don’t accept

List the insurance plans your practice doesn’t accept (out of network, not taking)

To mark a plan your practice doesn’t take, out of network or no longer accepted, add it to Insurance we don’t accept in Admin → Practice Info. Staff then see Not accepted on patients who have it, and patients who pick it online are told. It is off until you add a plan: with nothing listed, every plan works as before (“No plans listed. Every plan is treated as today.”).

  1. Open Admin → Practice Info and click Insurance (under Records). Scroll past Accepted Insurance to Insurance we don’t accept.
  2. Choose When a patient has it first.
    • Flag only: staff see Not accepted on the patient, calendar, check-in and booking screens, and patients who pick the plan online are told the practice doesn’t take it. Billing is unchanged.
    • Treat as self-pay: flags it the same way, holds claims to the plan for review instead of sending them, and starts the visit as Cash pay at the visit’s self-pay price in charge capture (the clinician can change it). What billing does is in Plans you don’t accept.
  3. Search under Search and add a plan (for example UnitedHealthcare Community Plan). Plans for your practice’s state are listed first; state plans are separate, so add each state’s plan you don’t take. Each result shows its payer ID and state.
  4. Only some plans under that insurance? Fill in Only some plans under this insurance (optional). Some plans you don’t take share an insurance with plans you do: TennCare (BlueCare) under BlueCross of Tennessee, a Dual Complete plan under UnitedHealthcare, TRICARE Prime under TRICARE East. Type a word from the plan name in Plan name has (for example PRIME, TENNCARE, DUAL COMPLETE), pick an Insurance type (for example Medicaid or QMB), or both. Hero reads the plan name and type from the patient’s latest eligibility check, matching whole words in any capitals, so the patient is flagged once their insurance has been checked, and again after every new check (a patient whose new check shows TRICARE Select is no longer flagged for a TRICARE Prime entry). Leave both empty to cover every plan under the insurance. You can list the same insurance more than once with different plans.
  5. Optionally add Notes (Why, or what staff should tell the patient…), then click Add on the plan. A plan already listed (same insurance and same plans) shows On the list. A message confirms Plan added.
  6. Add the same plan under its other payer IDs. Some insurers list a plan under more than one payer ID (for example UnitedHealthcare Community Plan Tennessee and the general UnitedHealthcare Community Plan, which some TennCare cards use). After you add a plan, Hero shows the others with the same name that work in your state, each with Add this too (same action and plans). Click Done to close the list.

Change or remove a plan

Each listed plan shows which plans it covers (Every plan under this insurance, or for example Only plans with “PRIME” in the name), its payer ID, states and notes, with a menu to switch between Flag only and Treat as self-pay (Plan updated), a Which plans button to change the plan name or insurance type, and a Remove button (Plan removed). Removing a plan takes the flag off its patients. A Claims held tag marks a plan whose claims are being held. Treat as self-pay on only some plans of an insurance never holds claims, because plans you do accept share its payer ID: those visits still start as Cash pay.

Who can change the list

Practice administrators and staff who manage practice settings (Practice Info). Adding a Treat as self-pay plan, or changing or removing one, also needs permission to manage claims (billers, billing managers, office managers), because it places or lifts a claim hold.

What patients see

When a patient picks a listed plan in the portal (sign-up, adding insurance, or booking), they see Insurance not accepted with a message that your practice doesn’t accept the plan and either that visits will be billed as self-pay or that the office will contact them about payment before the visit. It never stops them signing up, saving the plan or booking. An entry for only some plans of an insurance isn’t shown when a patient picks the insurance (nothing yet says which plan they have); once their insurance has been checked, the booking screen tells them the practice doesn’t accept their plan.

For the staff chip on a patient’s policy, see Not accepted on a patient’s insurance. This list is separate from Accepted Insurance, which the AI phone agent reads (Insurance the AI mentions).

4.1cContacts

Contacts: every lab, imaging center and office in one place (address book)

Admin → Contacts lists everyone your practice sends to: saved labs, imaging centers, doctors’ offices, hospitals, pharmacies, insurance companies, records offices, schools and others, plus your outside providers. Add, change or delete them in one place; the change shows up wherever you pick a recipient: Send fax, letters, Hero mail, and outside lab and imaging orders. Manage contacts in the address book search (letters, Hero mail) and in the Send fax window’s saved contacts opens the same page in a new browser tab, so what you are sending stays as it is.

Admin Contacts: Labs, imaging centers, offices and everyone else your practice faxes, mails or refers to. Add provider and Add contact buttons, a search box for name, city, fax or phone, Sort by Name, and chips All 8, Labs 2, Imaging 3, Providers and offices 1, Hospitals 1, Other 1, above a table of contacts with type, fax, phone and city
All your contacts in one list. The chips narrow it by type and show how many each has.

Find a contact

  • Chips (Labs, Imaging, Providers & offices, Hospitals, Pharmacies, Insurance, Other) narrow the list.
  • Search by name, city, or any part of a fax or phone number.
  • Sort by name, type, or most recently changed.

Add a contact

  1. Click Add contact.
  2. Enter the name and choose its type. For example Lab, Imaging center or Doctor’s office. Then add a fax number or a full street address. Phone, email, an attention line and notes for your staff are optional.
  3. Set up outside orders, if it takes them. For a lab or imaging center you send outside orders to, set Takes outside orders (lab, imaging or both) and its NPI.
  4. Click Save contact.

Change or delete a contact

  1. Click the row. Its details open on the right.
  2. Change what you need and click Save changes. Only what you changed is saved.
  3. To delete, click Delete and confirm. A lab or imaging center that was used on outside orders says how many; those orders keep the details they printed.
Admin Contacts with a lab selected: its details panel on the right with Name, Type Lab, Attention, Fax number being changed, street, suite, city, state and ZIP, Phone, Email and Takes outside orders
Click a row to change it in the panel on the right.
  • Fix it where you pick it. In the address book search, hover a saved contact and click Edit.
  • Numbers saved from the Inbox. A texting or calling number saved with Add to contacts in Inbox → Inquiries (Inbox tour) is a phone-only contact, typed for example Family or caregiver or Vendor and listed under Other. Its name and note are what the Inbox shows on texts and phone messages from that number, so a change here shows there too. A number already on a saved contact can’t be added a second time from the Inbox.
  • Who can. Everyone who sends faxes or letters sees and adds contacts. Changing and deleting is for providers, administrators and staff who manage the practice’s fax contacts.
  • Outside providers open in the same panel as Referring providers; add one with Add provider.
  • Not here: insurance payers’ phone numbers are in Billing → Payer phone book, and pharmacies for prescriptions come from Surescripts and stay on each patient’s chart.
4.2Physician management

Add physicians and keep their identifiers current

Physician Management is the source of truth for every clinician in the org. Each row carries the identifiers that downstream systems require: NPI for claims and SureScripts, specialty for online booking filters, and email for login. Each physician maintains their state-specific DEA registrations and prescribing addresses in Physician Settings. Deactivating a row hides the physician from scheduling and routing without deleting their history.

  1. Open Admin > Physician Management. A table opens with every physician in the org. Search by name, email, NPI, or specialty, and narrow the list with the status pills — All, Active, Inactive, On leave — each of which carries a live count.
  2. Use the Clinical visibility row for the second filter. Below the search bar, All / Visible / Hidden splits the roster by whether a physician is hidden from clinical contexts. Hidden rows also carry a Hidden badge.
  3. Click Add physician. Enter Name, Email (used for login), NPI, Specialty, and state-license information. The Email becomes their sign-in identifier, so use the address you want associated with their EMR account.
  4. Use Edit to update credentials. Keep NPI, licenses, specialty, and account details current here. Edits propagate to claim submission, SureScripts, EPCS, and chart signatures.
  5. Use Deactivate when a physician leaves. Deactivation removes them from booking, routing, and the Schedule Manager picker, but their signed notes, prescriptions, and claims remain in the chart for audit purposes.

Enter two or more DEA numbers (one per state) and their service addresses

A physician who prescribes in more than one state can save one DEA prescribing location for each state. The service or office address belongs to that DEA registration, while the physician's primary or mailing address remains separate.

  1. Open Physician Settings > Addresses. Use the physician's own settings rather than the organization roster when adding prescribing locations.
  2. Keep Primary / Mailing Address for general correspondence. This can be a home or mailing address and does not determine which address is sent with a controlled prescription.
  3. Under DEA prescribing locations, click Add DEA location. Enter a recognizable label such as Portland office, select the registered state, enter the DEA number, and complete that location's service address.
  4. Add every state where the physician prescribes. For example, save one Oregon registration with the Portland office and one Texas registration with the Austin office. Use mailing address can copy the mailing address as a starting point; edit the copied fields when the registered service location is different.
  5. Save settings. Hero validates duplicate states and DEA numbers and requires a complete service address for each registration. Each state takes one DEA number: a second registration for the same state is refused with “Only one DEA registration can be assigned to {state}.” A physician with two DEA numbers in two states adds one location for each.
How Hero chooses a DEA: For a controlled prescription, Hero uses the registration whose state matches the patient’s recorded address. A physician with only one registration signs under it for every patient, wherever they live: a Tennessee office’s Kentucky residents go out under the Tennessee registration, and the dialog notes the patient’s state without warning. The EPCS confirmation dialog always includes a DEA-location dropdown for review or override. Only when the physician has several registrations and none matches (or the patient has no state) does Hero ask for a location before signing; a manual choice for another state then shows as a warning so you confirm it deliberately.
Hidden vs. deactivated: the edit form's Hide from clinical contexts checkbox is a lighter touch than deactivation. A hidden physician stays available for admin maintenance and historical records but drops out of scheduling, booking, messaging, and routing pickers. Use it for billing-only or supervising identities that must keep signing history without appearing as a bookable clinician; use Deactivate when someone leaves the practice entirely.
Physician Management modal with a search box, All/Active/Inactive/On leave status pills, a Clinical visibility filter row, and a table of physicians showing name, email, NPI, specialty, and status badges
One row per clinician. The status pills and the Clinical visibility row are the two filters you'll reach for most.
Before going live: Verify every physician has a valid NPI on file. Claims will reject in Office Ally if the NPI is missing or mistyped, and SureScripts will refuse to enroll the provider for e-prescribing.
4.2aSpecialty & credentials

Pick a physician’s specialty when it is not on the menu, and where malpractice details go

The Specialty field in Admin → Physician Management is a search box over the national list of provider specialties (provider taxonomy codes), not a short menu. If you can’t find your specialty, search for it in a different way; you cannot type a specialty of your own.

  1. Open Admin → Physician Management and click Edit on the physician (or Add physician).
  2. Click Specialty and type into Type to search specialties…. The search matches the specialty name, its broader group and its description. Try the broader group (for example Psychiatry & Neurology or Nurse Practitioner) and the narrower name (Child & Adolescent Psychiatry), or type the 10-character taxonomy code from the physician’s NPI record. Each result shows its code on the right.
  3. Pick the result and save. When the old free-text specialty has no match yet, the form shows it under the field as Current: … until you pick one. A second specialty goes in Secondary taxonomy under Prescribing.

No specialties found for “…” means the words are not in the national list; use the code from the physician’s NPI registry entry instead.

Malpractice insurance. Hero has no field for malpractice (professional liability) insurance on the physician record. The physician form holds Credentials, Specialty, the DEA number and Prescriber SPI, the Licensure section (license numbers and states), Tax & billing and contact details. Keep the malpractice certificate in your own credentialing files.
4.2bYour signature

Set up your signature: where it is in Settings

A physician’s signature is saved in their own Physician Settings, on the Signature tab, not in the Admin menu. Letters, faxed letters and forms that you sign use it.

  1. Click Settings in the top bar, then Profile Settings. The Physician Settings dialog opens.
  2. Click Signature in the left column. It shows Your current signature: or No signature has been saved.
  3. Click Create Signature (or Edit Signature). In the Digital Signature Editor, draw your signature with the mouse, trackpad or a finger; Clear starts over.
  4. Click Save Signature.

Below the signature, Let my staff release forms and letters with my signature decides whether staff releases carry it; see Let staff use your signature. Each physician saves their own signature; an administrator cannot draw it for them. Staff accounts have no saved signature.

4.3Staff & assistants

Invite medical assistants and front-desk staff

Staff & Assistants is the non-physician roster. Medical assistants, scribes, schedulers, front-desk users, and office managers live here. Office Manager is a staff role profile, not an administrator login; its delegated permissions determine which admin and billing tools it can use. Each row carries credentials (MA, RN, scribe, etc.), an email for login, and a supervising physician link — assistants act on behalf of their supervisor for orders, in-basket routing, and chart access.

  1. Open Admin > Staff / Assistants. The Assistant Management modal opens with the full staff list. Toggle between All, Active, Inactive, and Suspended tabs to filter by status.
  2. Click + Add Staff. Walk through the staff wizard: name, email, credentials (free text — MA, RN, LPN, Scribe), and the supervising physician they're paired with on the Profile step, then the Access step — “Pick one or more role profiles, then fine-tune individual permissions if needed.” Tick Role profiles such as Front Desk, Medical Assistant, Biller, or Billing Manager, and use Customize granular permissions for anything extra.
  3. Use Edit for ongoing changes. Re-link a supervisor when an MA changes pods, update credentials when they upgrade, change email if they migrate to a work address.
  4. Use Deactivate when a staff member leaves. They lose login access immediately; their prior in-basket actions and chart edits remain attributed to them.
Assistant Management modal listing staff with name, email, access level, credentials, supervising physician, status, and Edit/Deactivate actions
Each assistant is tied to a supervising physician. That link drives in-basket routing and chart-access scope.
Supervisor link matters: When a patient messages their physician, replies and refills can route to that physician’s assistant pool first. Get this link right at onboarding so messages stop piling up in the wrong queue.
WorkflowRole profiles that include it
Open a patient’s billing without the clinical chart, and fix the address and insurance a claim needs (Patient billing)Biller, Billing Manager, Office Manager
Book a visit, sign and send, or release a claim even though the insurance check failed, with a reason (Billing → Eligibility)Front Desk, Biller, Billing Manager, Office Manager
Triage patient refill requests (Refills)Medical Assistant, Nurse
Review pre-visit intake (Intake review)Medical Assistant, Nurse, Intake Coordinator
Run the check-in kiosk (Kiosk)Front Desk, Medical Assistant, Nurse, Intake Coordinator, Office Manager, Check-in Kiosk
Enroll and revoke walk-up tablets (Walk-up tablets)Office Manager
Book and manage treatment series (Treatment series)Front Desk, Medical Assistant, Nurse, Intake Coordinator, Office Manager
Start a patient’s work notes, school notes and forms, and approve, reject, edit, print, fax and email them, releasing them for a provider (Forms & Letters)Front Desk, Medical Assistant, Nurse, Clinical Staff, Office Manager, Intake Coordinator, Referral Coordinator, Organization Owner — not Biller, Billing Manager or Back Office Biller
New role profile: Intake Coordinator. “Reviews pre-visit questionnaires and paperwork, contacts patients, and schedules.” Pick it on the wizard’s Access step for staff who screen intake before visits; it carries no payment, billing, or chart-documentation rights. Practice owners can open Billing, including physician owners, when billing is enabled for the practice. Individual financial actions still have their own access checks.

Forms & Letters: releasing letters for a provider

The Forms & Letters group in Customize granular permissions holds one permission, Start forms and letters for a patient, and approve, reject, edit and send them. (forms_letters.manage). Under it the panel lists what it covers: starting a work note, school note or form for a patient (by phone, in person, fax or email); approving or rejecting forms and letters the patient asked for, releasing them for a provider; and editing, printing, faxing and securely emailing released forms and letters. Every role profile that works with patients at the desk or in the clinic includes it (table above); billers do not. Providers and practice administrators can do all of it without the permission.

  1. To take it away from one person, open Admin > Staff / Assistants, Edit the staff member, go to the Access step and open Customize granular permissions.
  2. Untick the box under Forms & Letters. It is marked −Removed (removed from the role profile) and the change applies only to this person. Save.
  3. What they keep. With chart access (patient.view) they still see the patient’s Forms & Letters list and can open, print, fax and download released documents. They can no longer start, release, reject, edit, withdraw or email them.

A staff release never signs as the provider: the document carries the provider’s saved signature only if that provider turned on Let my staff release forms and letters with my signature in their own settings, and otherwise the staff member’s name released on the provider’s behalf; see Review & release.

Front-desk refunds have a separate patient-payment refund permission. It allows refunds without granting write-offs, fee waivers, or credit adjustments. Waiving a patient’s no-show or late cancellation fee or removing an unpaid copay has its own permission (Waive a patient’s no-show or late cancellation fee or remove an unpaid copay), which no role profile includes: give it to one person and they can, with a reason, waive those fees and remove a copay nothing has been paid toward, even if their practice financials are hidden, but not change a copay’s amount. Taking payments also requires payment-collection permission and patient-invoice access. Dues refunds use the separate membership-refund permission. Review the staff member’s granular permissions for the intended workflow; see Payments & card readers.

Some permissions only the practice owner or an administrator can give, and no role profile includes them: changing the practice’s security settings (Security settings) and emergency chart access (Emergency chart access). An office manager can assign whole role profiles but not these. Staff add their own passkey or text-message number from the shield button Sign-in & security in the top bar (see Signing in & passkeys).

4.3aPasswords & sign-in links

Reset an employee’s password, or resend their sign-in email

An administrator cannot see or type an employee’s password. To reset a staff member’s password, send them a new password setup email (or a one-time link) from Staff / Assistants; they then choose a new password themselves. Anyone can also reset their own password with Forgot password? on the sign-in screen.

  1. Open Admin → Staff / Assistants and find the person. Their status must be active; a deactivated account needs Activate first.
  2. Click Resend setup email and confirm “Send a password setup email to …?” The email carries a link that lets them set a new password. You can send it again after five minutes.
  3. Email not arriving? Setup status shows whether a sign-in has been recorded and whether the email was accepted for delivery. For someone who has never signed in, Generate setup link creates a One-time setup link to hand them privately (“This link permits setting their password.”).

Physicians, and resetting your own password

  • Forgot your password: on the sign-in screen click Forgot password?, enter your Work email and click Email me a link. The link expires about an hour after it is sent; check your spam folder.
  • Know your password and want to change it: physicians open Settings → Profile Settings → Password, enter the current password and a new one of at least 8 characters.
  • Physician Management has no reset button. A physician who is locked out uses Forgot password?.
4.3bAdministrators

Make someone an administrator, or add a second admin

There is no switch in Hero to turn an existing user into a practice administrator. To give a staff member most of the admin tools, assign the Office Manager role profile (“Operational administration across staff, billing, scheduling, and portal settings.”). To add a second full practice administrator, contact Hero support.

  1. Open Admin → Staff / Assistants and click Edit on the person (or + Add Staff for someone new).
  2. On the Access step, tick Office Manager. Use Customize granular permissions to add or remove single permissions for this person.
  3. Save. They see the admin tools their permissions allow the next time the menu loads.
What only the practice owner or an administrator can do. Some permissions are not in any role profile, and an office manager cannot give them: changing the practice’s security settings and emergency chart access. A request for a second full administrator should come from the practice owner: email support@heroemr.com with the person’s name and work email.
4.4Patient registration

Search, add, and edit patients from the admin console

Patient Registration is the org-wide patient directory. Use it to add patients that bypass online booking (walk-ins, phone bookings, migrated charts) or to fix demographics that came in wrong from the portal. The list shows every patient in the org, regardless of which physician they see.

  1. Open Admin > Patient Registration. This is not a modal — it opens as its own workspace tab titled Patient Registration (“Manage patient records and portal access”), with a searchable, paginated list of every patient. Search by name, email, or MRN.
  2. Filter by portal status. The All Portal Status dropdown offers No Invitation, Pending (invited but not signed in), and Active. Row badges read No invite, Pending, or Active to match.
  3. Filter by patient status. A second dropdown, All Patient Status, filters on the clinical relationship instead: Active, Inactive, Prospective, Discharged, Transferred out, or Deceased. The two filters combine, which is how you find (say) active patients who never accepted a portal invite.
  4. Click Add Patient. The Register New Patient form opens. Enter First/Last name, DOB, sex, email, phone, and address. Unless your practice changes it, phone and (for adults) email are required, and so are a parent or guardian’s phone and email for a patient under 18; your practice chooses which fields are required, and can add an Insurance section, in Registration form settings. A patient registered without an email gets no portal invitation. The address ZIP accepts only a 5-digit ZIP or a 9-digit ZIP+4 (digit-only entries are reformatted, so 410561234 saves as 41056-1234); it may be left empty, but insurance claims will wait on a complete address.
  5. Send or resend a portal invite from the row. The badge in the Portal column is a button while portal access is still No invite or Pending — hovering it swaps the label to Send invite or Resend invite. Once the patient's portal access is Active the badge is plain text. To manage access after that, click the key button on the row (Portal access): Change email, Send sign-in link, Resend invite, Remove, and Add parent or guardian. See Sign-in email & links.
  6. Edit demographics. Click Edit on any row to fix name spelling, sex, contact info, or address.
Patient Registration workspace tab with search, an All Portal Status filter, an All Patient Status filter, and a list of patients showing name, DOB, email, phone, MRN, a clickable portal badge, and an Edit action
The directory shows every patient in the org. Use the portal-status filter to chase down invites that never converted, and click the portal badge itself to resend one.
For data migration: Bulk-import patients before go-live rather than entering them through this modal one at a time. Contact support@heroemr.com for a CSV template.
4.4aRegistration form

Registration form: insurance and the fields your practice requires

Your practice decides what the front desk must fill in on Register New Patient, and can add an Insurance section to it. The settings apply to Register New Patient for everyone in the practice; patients who sign up online, imported charts and charts made from referrals or faxes are not affected, and neither are edits to existing patients.

Open the settings

Open Admin → Practice Info and choose Registration form, or click Form settings at the top of Admin → Patient Registration. Both show the same settings. Practice administrators, the practice owner, and staff allowed to manage practice information can change them. Nothing changes until you click Save.

Insurance on the registration form

Turn on Show insurance on the registration form (off by default) to add an Insurance section to Register New Patient:

  1. Choose Has insurance or Self-pay / no insurance. Neither is chosen to start with. Self-pay adds no policy: “The patient is billed as self-pay until a policy is added.”
  2. Click Scan card to read the insurance card. Upload photos or use this device’s camera (front, and back if you like), then Read card; or, under Take the photos with a phone, show the QR code and take the photos with the patient’s phone. Check what the scan filled in: fields that were hard to read are listed after Double-check:. Pick the payer from the list.
  3. Fill in the policy. Payer, member ID, group, coverage dates and the relationship to the patient. If someone else holds the policy, enter that person’s name, date of birth, sex and address. Click Add secondary insurance if the patient has a second policy.
  4. Click Create Patient. Hero saves the patient first, then the insurance, and checks eligibility the same way the Insurance tab does. The card photos are saved to the policy.

If the insurance can’t be saved, the patient is still created and nothing you entered is lost: “The patient was created, but the insurance wasn’t saved. Nothing you entered is lost.” Fix it and click Save insurance, or click Finish on the Insurance tab to finish it on the new chart. If the card was read but its photos couldn’t be kept, the form says so; scan again to keep them, or save without them.

Required fields

Under Required fields, switch Required on for each field the front desk must always fill in:

FieldNotes
EmailPatients 18 and over. Required unless you switch it off.
PhoneRequired unless you switch it off.
Parent or guardian phone, Parent or guardian emailPatients under 18. Required unless you switch them off.
Parent or guardian date of birth, Parent or guardian sexPatients under 18.
Mailing addressStreet, city, state and ZIP.
County, Race, Ethnicity, Mother's maiden name
Insurance or self-payOnly while the Insurance section is shown.

First name, last name, date of birth and sex are always required, and for patients under 18 the parent or guardian’s first and last name. Register New Patient lists what is still missing next to its save button, for example Still needed: Phone, Mailing address, and can’t be saved until it is filled in.

No email, no invitation: a patient registered without an email gets no portal invitation (“No portal invitation was sent because there is no email on file. Send one later from Patient Registration.”). Send it later from the patient’s row in Patient Registration.

To fill in the form from the patient’s driver’s license or other photo ID, see Photo IDs and patient photos.

4.4bInactive patients

Make a patient inactive (archive a chart), or make an inactive chart active again

To archive a patient who no longer comes to the practice, change their Patient Status to Inactive (or Discharged, Transferred out or Deceased). To reactivate an inactive patient, set it back to Active. Nothing is deleted: the chart, notes, prescriptions and claims stay, and the patient still comes up in patient search.

  1. Open Admin → Patient Registration and search for the patient by name, email or MRN. To find patients who are already inactive, set the All Patient Status filter to Inactive.
  2. Click the pencil on the patient’s row (its tooltip reads Edit demographics). The Edit Patient form opens.
  3. Pick the new status in Patient Status, under Identity: Active, Inactive, Prospective, Discharged, Transferred out or Deceased.
  4. Click Save Changes. The new status shows on the chart’s Demographics card as Status.
StatusWhat changes
Inactive, Discharged, Transferred outAutomated messages stop: reminders, follow-ups, questionnaires, surveys, campaigns and balance reminders. Staff can still send a message by hand. An active membership ends at the end of the current billing period.
DeceasedNo communications at all, including messages staff send by hand. An active membership is cancelled straight away.
ActiveAutomated messages start again for this patient.
Who can change it. Practice administrators, and staff with the permission Change a patient’s status (the Front Desk, Medical Assistant, Nurse and Office Manager role profiles include it). Without it the field is greyed out with the hint “Changing patient status needs the ‘Change a patient’s status’ permission. Ask your practice administrator.” Patient Status is set here, not in the chart’s own Edit demographics form.

Patient Status is not the same as a visit “on hold”. A website or AI phone booking that is waiting for the patient to finish online registration is a scheduling hold, handled from the schedule, not from the chart’s status.

4.4cDuplicate charts

Duplicate patient charts: merge them, or delete a registration made by mistake

Hero has no button to delete a patient or a patient registration, and staff cannot merge two charts themselves. Every chart is kept as part of the medical record. When the same person has two charts, ask Hero support to merge them; when a chart was made by mistake and has nothing in it, make it inactive.

  1. Check that it really is the same person. Compare name, date of birth, phone and email on both charts, and note both MRNs.
  2. Ask Hero support to merge the charts. Email support@heroemr.com or press F9 (Report A Problem) with the two MRNs and which chart should be kept. Do not include other patient details. Support moves what was recorded on the duplicate onto the chart you keep; the duplicate stays behind as an inactive record so the audit trail is complete.
  3. A chart made by mistake for nobody (a test patient, a typo that created a second patient): set its Patient Status to Inactive so no reminders go out; see Make a patient inactive.

How Hero tries to stop duplicates

  • On Register New Patient. If a chart in your practice has the same details, the form stops with “This may already be a patient” and lists the match (date of birth, phone ending, masked email and MRN). Click Open this chart if it is the same person. If it is someone else, the save button now reads Create a new chart anyway.
  • Charts made by online registration, check-in and similar channels. When one may match an existing chart, the new chart gets a Possible duplicate chart chart alert naming the other chart’s MRN and what matched, and a reviewer gets a to-do. If they are the same person, ask support to merge them as above; otherwise dismiss the alert (see Chart alerts).
4.5Patient portal branding

Brand the patient portal without a code deploy

Patient Portal Configuration controls both what your patients can do in the portal and how it looks to them — feature toggles first, then color palette, logo, typography, and a live preview. The defaults work out of the box; customize when you want the portal to match your practice's identity or your landing site.

  1. Open Admin > Patient Portal Configuration. The modal opens to the Features tab. The tabs run down a left rail: Features, Teens & guardians, Correction requests (only while Record correction requests is on in Additional Features), Color Scheme, Logo, Typography, and Live Preview. What parents and guardians of minors can see is set on Teens & guardians — see Teens & guardians. The deadlines for answering patients’ correction requests are set on Correction requests — see Record correction requests.
  2. Decide what the portal offers. The Features tab carries twelve toggles, all on unless you turn them off (Online Bill Pay is listed only while billing is on): Secure Messaging (portal Messages tab and new-message alerts; staff replies over SMS or email keep working), Online Scheduling (book, reschedule, cancel, waitlist — viewing appointments, check-in, and telehealth join stay available), Online Bill Pay (balances, statements, saved cards, pay links; staff-collected payments are unaffected), Insurance Self-Service (patients adding their own cards; staff entry and the kiosk are unaffected), Health Records (labs, imaging, shared media, diagnoses, patient instructions), Visit Notes (signed visit notes and visit summaries; it sits under Health Records and only applies while that is on, so you can hide notes while keeping results visible), Letters & Forms (patient-initiated requests; questionnaires and required paperwork are unaffected), Refill Requests (the refill button, not the medication list), Document Uploads, Caregiver Sharing (adult patients inviting family or caregivers to help; turning it off stops new invitations only), Family Access Requests (a parent asking the practice to add another parent or guardian; turning it off stops new requests only), and Nutrition (food log, sharing and nutrition activities) (the food log and nutrition targets in the My Hero app; turning it off closes Nutrition in the app, keeps food logs, and the chart still shows anything already shared). Turning one off hides that surface from patients — it does not delete anything.
  3. Choose when patients see lab and imaging results. Still on Features, When patients see lab and imaging results is Right away unless you change it. After a clinician releases them holds each new result until a clinician releases it, or until Release automatically after (24, 48 or 72 hours) ends — see Releasing results after review.
  4. Set the Orientation intake questions. Still on Features, the Orientation intake toggles control what new patients are asked during portal orientation. The history questions are Past Surgical History, Social History (not asked on proxy accounts), Family History, and GYN History (offered only to patients whose recorded sex is female or other, never on proxy accounts). Newly created organizations start with all four on. Family History is on for every practice unless you turn it off; for a practice set up before these settings existed, the other three start off until you turn them on, so confirm the setting before go-live rather than assuming it. When none is on, patients get no Health History step (Is health history part of intake?). The Social Security Number card in the same list is separate: it always starts off, even for a brand-new practice. Turn it on and patients are asked for their Social Security number while they set up their profile, and can skip it. Staff see only the last four digits, and every time someone views the full number it is logged (see The Social Security number row).
  5. Pick a Theme Source. On Color Scheme, three options: Current default theme (Hero defaults), Landing site theme (pulls colors already chosen for your physician landing site so portal and marketing match), or Custom colors (set each design token by hand).
  6. Tune the Palette. Each color chip maps to a specific portal design token: Brand button, Brand hover, Brand soft panel, On-brand text, Page background, Cards, etc. The right-hand Preview updates live.
  7. Watch the Accessibility card. Hero scores seven text/background pairs for WCAG contrast as you edit and prints each ratio — green when it passes, red when it doesn't. If any pair falls below AA you get “Some color pairs are below WCAG AA and cannot be saved” and the Save button stays greyed out until you fix it. A disabled Save almost always means a failing contrast pair, not a bug.
  8. Upload a Logo. Switch to the Logo tab, click Choose, and pick a PNG, WebP, or JPEG no larger than 2 MB — a transparent PNG or WebP looks best. SVG is not accepted and is rejected with “Unsupported logo type.” The logo appears in the portal header and on confirmation emails.
  9. Pick Typography. The Typography tab swaps the portal font family. Defaults match the EMR.
  10. Check the Live Preview. Renders an actual portal card with the active palette, so you can sanity-check the whole theme before committing.
  11. Click Save. Active patient sessions keep the old theme until they next reload; new sessions and emails pick up the change immediately.
An earlier Patient Portal Configuration modal open on the Features tab, with a left rail of Features, Color Scheme, Logo, Typography and Live Preview, an All changes saved badge, the blue callout Turning a feature off hides it everywhere, and the first feature cards — Secure Messaging, Online Scheduling, Online Bill Pay and Insurance Self-Service — each Enabled and listing its impacted surfaces
The modal lands on Features (this picture predates the Teens & guardians tab and the newer toggles): each section toggle names the surfaces it takes away, under the callout that turning one off hides it everywhere. Theme Source, the palette, and the live preview live one tab down, on Color Scheme.
4.14Security settings

Choose how long people stay signed in and how they sign in

Admin → Security holds the sign-in rules for everyone in your practice: how long someone can sit idle before Hero signs them out, how often they confirm it’s them again, whether a passkey can live on a phone or a security key, and, when your practice uses it, the terms of emergency chart access. The page reads: “These settings apply to everyone in your practice. Nothing changes until you save.”

  1. Open Admin → Security. In the Admin menu it sits under Money and admin; you can also type “security” in Find an admin page. The practice owner and practice administrators always see it. Other staff see it only if an owner or administrator gave them the permission “Manage practice security settings: idle sign-out and how often two-step verification is repeated.” An office manager does not get it from the role alone.
  2. Pick a value for each setting you want to change. A changed row is outlined and marked Changes when you save. The bar at the bottom says what will change, for example “2 unsaved changes: Sign out after 30 minutes of inactivity, repeat two-step verification every 8 hours.” Your choices are kept if you switch to another Hero tab, and the browser asks before you close or reload the page.
  3. Click Save Changes (or Discard to start over). The bar confirms with “Saved. 1 setting updated.” Open Hero tabs pick up a new idle limit within a few minutes.

Sign-in sessions

SettingChoices (default)What it does
Sign out after inactivity5 minutes to 8 hours (1 hour)Everyone is signed out of Hero after this much time with no activity. A one-minute warning comes first, and a recording or phone call in progress keeps the session open (see Staying signed in).
Sign patients out of the portal after inactivity5 minutes to 3 hours (30 minutes)Patients are signed out of the patient portal after this much idle time. They see a one-minute warning and can choose to stay signed in. Patients already signed in get the new time the next time they open the portal.
Repeat two-step verification1 to 24 hours (12 hours)People confirm it’s them with a text-message code or a passkey when they sign in, and again once this much time has passed. A shorter limit applies right away: anyone who verified longer ago than the new limit is asked again on their next action. A longer limit applies from each person’s next verification.
Also end idle sessions on the serverOff (default) or OnOff keeps the usual behavior: the app signs idle people out on screen. On: Hero itself stops accepting a sign-in that has been idle longer than the limits above, even if the browser was closed or the computer went to sleep instead of signing out. The person signs in again.

Passkeys and two-step verification

A passkey signs someone in with Touch ID, Windows Hello or their computer PIN, with no code to type. People without one confirm it’s them with a text-message code.

  • Passkeys on phones and security keys (Off (default)). On lets people keep their passkey on their phone (they scan a QR code to sign in) or on a USB security key. Turn it on when some computers have no Touch ID, Windows Hello or PIN. Passkeys already set up keep working either way, and the patient portal and the mobile apps are not affected.
  • Your team lists everyone on the clinical team with how they sign in. Three tiles count the people with a passkey, using text-message codes only, and not set up yet. Each person shows Provider, Administrator or Staff, their email, and one badge: Passkey, Passkey (phone or key), Text-message codes or Not set up (plus Text codes too when they have both).
  • The list only reports. A passkey belongs to one person’s device, so each person adds their own (see Add a passkey). Set up my passkey opens your own Sign-in & security window.

Emergency chart access

This group appears only after your practice turns on Emergency chart access in Admin → Additional Features (off by default). It sets the terms for staff who break the glass; who may use it is chosen in Staff permissions. The full workflow is in Emergency chart access.

SettingChoices (default)What it does
Access they getFront desk, Medical assistant, Nurse, Referral coordinatorThe staff access level used while emergency access lasts. Nurse access lets them read and update the chart; front desk access is mostly demographics and scheduling.
How long it lasts15 minutes, 30 minutes, 1 hour, 2 hours, 4 hoursAccess ends on its own after this time; the person can end it sooner. A new emergency needs a new reason.
Who is toldPractice administrators, People who can view the Audit Log, Administrators and Audit Log viewersThese people get an urgent to-do, linked to the chart, each time someone uses emergency access. Give your privacy officer Audit Log access to include them.

Practice Setup: Sign-in security

Admin → Practice Setup has a Sign-in security group with two steps; each opens this page.

Review sign-in security

Done once someone saves this page at least once. Until then it reads “Using Hero’s defaults: 60-minute idle sign-out, verify again every 12 hours.” Its details show the idle sign-out, how often people verify again, and whether passkeys may live on a phone or security key.

Passkeys for your team

Counts only, for example “3 of 5 have a passkey · 1 uses text-message codes · 1 has neither”. It shows as done when everyone has a passkey or text-message codes. The names are on this page’s Your team list, which needs the security-settings permission.

If the page will not load: it reads “Unable to load security settings.” with Try again. A save that fails says so in the bottom bar and keeps your choices. Until the page has been saved once, Hero uses the defaults shown above.
4.15Signing in & passkeys

Sign in, add a passkey, and stay signed in

Signing in

On Clinician Sign In, enter your email and password and click Sign in with password, or click Sign in with passkey. While Hero signs you in, the sign-in panel stays on screen and shows Signing you in with your email and each step as it finishes:

  • Password: Checking your password → Confirming your practice access → Opening your workspace.
  • Passkey: Confirming your passkey → Confirming your practice access → Opening your workspace.
  • A two-step verification code: Checking your code → Opening your workspace.

It usually takes a few seconds. After about eight seconds on one step the panel adds “Still working. A slow connection can take a little longer.” If the password is refused, you stay on the sign-in screen with your email still filled in.

Add a passkey

  1. Open your own sign-in settings. Providers and administrators: Settings → Sign-in & Security (it opens your profile settings on the Security tab). Staff: the shield button Sign-in & security in the top bar. The staff window, Sign-in & security, holds your passkeys and your text-message number for two-step verification.
  2. Click Add Passkey (Add Your First Passkey if you have none). Hero may first ask you to confirm it’s you: “For security, confirm it’s you before adding a passkey.” After you confirm, setup continues on its own.
  3. Choose where the passkey lives (only when your practice allows phones and security keys). Where should the passkey live? offers This computer (Touch ID, Windows Hello or your computer PIN) or My phone or a security key (scan a QR code with your phone, or plug in a USB security key; keep your phone nearby when you sign in). On a computer with no Touch ID, Windows Hello or PIN, My phone or a security key is chosen for you.
  4. Name it and click Create passkey. Device name is required (for example My laptop or My phone). Then follow your computer’s or phone’s prompt.

If your practice keeps passkeys on the computer and this computer cannot make one, Hero says so: you can keep signing in with a text-message code, and your practice administrator can allow passkeys on phones and security keys in Admin → Security. A passkey on a phone or security key cannot be used for offline downtime sign-in on the computer.

You seeWhat it means and what to do
“Passkeys can’t be created on this web address. Open your practice’s usual sign-in address and try again.” or “Passkeys can be added at …”Passkeys belong to one web address. Open the address shown (your practice’s usual sign-in page) and add the passkey there.
“Setup was cancelled. Please try again.”The device prompt was closed or timed out. Click Create passkey again.
“This device already has a passkey for your account.”You already have one here; use it to sign in.
“Passkey not added. Confirm your identity to add a passkey.”The confirmation step was cancelled. Start again and finish confirming it’s you.
Passkeys Not SupportedThis browser cannot make passkeys. Use a current Chrome, Safari or Firefox, or keep using text-message codes.

To remove a passkey, click Delete on it and confirm with Delete passkey. The confirmation warns that removing it may disable offline downtime sign-in on that device.

Staying signed in

  • The warning. One minute before the practice’s idle limit, Still there? appears: “You have been inactive for about 60 minutes. To protect patient information you will be signed out in … seconds.” Click Stay signed in, or Sign out now. Clicking elsewhere does not dismiss it.
  • Recordings. If a recording is not in a note yet, the warning adds that it will be deleted from this computer when you are signed out. A recording in progress keeps you signed in; a paused one does for up to an hour.
  • Phone calls. A live or ringing phone call keeps you signed in, and so does a computer set up as a phone workstation.
  • Several tabs. Activity in any Hero tab in the same browser counts for all of them.
  • Signed out by the server. When Also end idle sessions on the server is on, reopening a browser that sat idle too long shows the sign-in page with, for example, “You were signed out after 60 minutes of inactivity. Please sign in again.”
4.15aReports: provider face time

Provider face time report: time with patients, billed codes and chart closing (practice owner)

The Provider face time report (“Time with patients, billed codes, chart closing”) lives in Practice Health under Reports (category Staff time). It shows, for each provider, how much time they spent with patients, what was billed, which visits fall short of the time their codes need, and how quickly charts were closed. Only the practice owner sees it until the owner shares it from the report’s Share button; Admin → Reports now opens it in Practice Health.

  1. Open Practice Health → Reports and pick Provider face time.
  2. Choose the Period: This week, Last 7 days, This month, Last month, or your own From and To dates (up to 92 days). Narrow to one Provider or keep All providers.
  3. Read the practice tiles and the Providers table. Columns include Visits, Face time, Video time together, Ambient minutes, Phone talk, Time flags, Open charts and Avg time to close chart. Averages are per visit; click a column to sort.
  4. Click a provider to see their visits, then filter with All, Flagged only or Open charts. Each visit row has the date, visit type, Setting, scheduled and check-in to check-out time, Billed codes and the Time check.
  5. Click Download CSV to save the visits as a spreadsheet file.
How these are measured. Face time is the longer of the video time with both of you on the call and the ambient recording time. Time flags compare that time with the minimum the billed codes require (psychotherapy 90832–90838, crisis 90839, prolonged 99417/G2212); prolonged codes count the whole day’s time, including charting, so a flag is worth a look rather than an error. E/M office visits (99202–99215) can be billed on medical decision making, so they are never flagged. Time to close chart runs from the end of the scheduled visit to when the note was signed.

Need help? Email support@heroemr.com.