Questionnaires & the paperwork manager
Decide what patients complete before a visit and how it reaches them: the questionnaire library, the rules that assign them, and the paperwork manager.
Questionnaires & the paperwork manager
Decide what patients complete before a visit and how it reaches them: the questionnaire library, the rules that assign them, and the paperwork manager.
Two features, one pre-visit flow
Questionnaires and Previsit Paperwork are separate full-page workspaces because they answer different questions, but the patient sees them as one connected experience the day they book. Each one opens in its own tab inside Hero EMR, so you can leave it open while you work.
Questionnaires (per physician)
- Live under
Settings > Questionnaires, or underAdmin > Questionnaireswhen the practice manages them for everyone (§2.20). - Each physician (or the practice) picks which validated screeners or intake forms run for which visit types (PHQ-9 for behavioral health, ROS for new patients, etc.), or on a recurring schedule.
- The questionnaire library is shared org-wide and includes a standardized catalog plus anything your physicians have cloned and customized.
- Answers feed into the chart and can drive scoring (depression severity, fall risk, etc.).
- For minors and parent-managed teen accounts, questionnaires are delivered to the parent/guardian on file. The workspace header repeats this reminder.
Previsit Paperwork (per organization)
- Lives under
Admin > Previsit Paperwork. - Org admins build the consent, financial, telehealth, and policy documents patients sign.
- Each template has its own scope, signing cadence, content sections, and response fields.
- Each form is either Live (added to patients' visits automatically) or Off (goes out only when your staff send it).
- Changing a form's wording saves a new version, so every signed copy keeps the exact wording the patient signed.
Browse and customize the questionnaire library
Before you assign questionnaires to visit types, decide which ones you want available. The library sidebar lists up to three groups, in this order: Your questionnaires (the current physician's personal versions), Organization questionnaires (cloned and edited by anyone in the org), and Standardized library (system-provided instruments like PHQ-9, GAD-7, AUDIT-C). Empty groups are hidden, so on a brand-new org you will only see Standardized library until something is cloned. Only items in Your questionnaires are editable; everything else must be cloned first.
- Open
Settings > Questionnaires. From the top toolbar, open Settings, then choose Questionnaires. The Questionnaires workspace opens as its own full-page tab. Its left rail has two entries — Visit Rules (selected by default) and Library. - Click Library in the left rail. The library opens with a sidebar of all available questionnaires, grouped by ownership. Use the search box or toggle Include inactive if you want to see deactivated entries.
- Preview a standardized questionnaire. Click any entry to load it in the main panel. Preview mode shows the short name, category, full question wording, response options, and required flags as the patient will see them.
- Clone before editing. Standardized and organization questionnaires are read-only. To customize one, click Duplicate to edit. The cloned copy lands in Your questionnaires and unlocks every field.
- Edit metadata and questions. Switch to Edit mode. The metadata fields are Short name, Category (depression, anxiety, mental health, substance use, trauma, pain, cognitive, functional, perinatal, developmental, preventive, or custom), Display name, Description, Estimated minutes, and Default frequency days.
- Add or reorder questions. Each question card has a type (likert, single select, multi-select, text, number, boolean, scale, score, or instruction), a required flag, the question text, and — for choice-style types — value/label pairs. Use the up/down buttons to reorder.
- Configure scoring (optional). For instruments that compute a score, paste or edit the scoring config JSON. Leave it blank for purely informational forms.
- Click Save & publish. Every save publishes a new version. The footer reminds you that in-flight assignments stay intact — patients already on an older version finish on that version, and new assignments pick up the latest.
Build a questionnaire with skip logic, a score, forms an answer sends, and answers saved to the chart
You can build any intake form or scored measure yourself in the questionnaire library (Settings > Questionnaires, or Admin > Questionnaires > Library for the practice), with no JSON. Start from New questionnaire or copy an existing one. Each question card has four optional settings, shown as links under the question until you use them.
- Skip logic: Show only when… Show a question only after a certain answer to an earlier question, for example "Where does your income fall?" only when the patient answered Yes to "Will you be requesting sliding-scale rates?". Pick the earlier question, then is / is not (choose one or more answers), is answered / is not answered, or is at least / is at most (number answers). With two or more conditions choose whether all or any must be true. The card then reads "Shown when …". A rule can only look at questions above it; moving or deleting the question it depends on flags the card and blocks publishing until you fix it.
- Only on telehealth, or only in person: Add a visit condition. One form can serve both kinds of visit: under Show only when…, click Add a visit condition and choose the visit is telehealth or the visit is in person, for example for a state telehealth-consent question. You can combine it with answer conditions (“Patients skip this question unless the visit and the answers above match.”). Telehealth or in person comes from the visit type; a form sent without a visit asks the question. A skipped question is never required, and its answer is not saved. Use it instead of keeping a telehealth copy and an in-person copy of the same form in sync.
- Send a form when answered… When the answer is what you pick (for example Yes), Hero also sends another questionnaire from your practice or Hero library, or one of your paperwork forms, to the same patient as soon as they submit. It is linked to the same visit when there is one, and it is not sent again while the patient still has an open copy. Up to five forms per question.
- Save the answer to the chart… Fills the patient’s chart from their answer: Lived (preferred) name, Pronouns, Gender identity, or the emergency contact’s name, relationship or phone. Fields are mapped by you, not guessed by AI. A choice question saves the answer’s wording. The patient’s newest answer replaces what was there (staff can change it back), and the chart’s change history names the questionnaire it came from. Pronouns is saved only while patient pronouns are turned on for your practice (
Admin > Additional Features). - Points (for a score). Turn on Score this questionnaire in the scoring section, then choose Add up the points (each answer is worth the points you give it; the score is the total) or Count the answers that meet a threshold. Mark which questions count toward the score, give each answer its points, add Score bands (from, to, label such as Positive screen) and optional alerts for staff when a question reaches an answer you choose. Set an alert’s level to Chart label only (no alert, to-do or notification) and type a Chart label (for example Firearm access) to put that label on the patient bar as a Warning chart alert: it sends no safety alert, to-do or notification. Hero shows the highest possible score and warns about gaps or overlaps between bands. Complex scoring (subscales and the like) opens under Advanced: edit as JSON.
Try it (a tab beside Edit and Preview) runs the questionnaire the way a patient sees it: questions appear and disappear as you answer, and it lists what would happen on submit ("Would send: …", the chart fields it would save) and the live score and band. Nothing is saved or sent.
- What patients see. The portal, kiosk and staff Fill in with patient show only the questions that apply, and the progress count counts those. A skipped question is never required, its answer is not kept, and it doesn’t show as unanswered when staff read the response. If a patient changes an earlier answer, follow-ups that no longer apply drop out.
- Editing a practice questionnaire. Practice administrators (and staff with the templates permission) can edit a Practice questionnaire in place with
Edit: "Changes apply to every patient who gets this form from now on. Answers already given stay as they were." Publishing makes a new version and moves the practice’s rules to it. - A sent form and a score live separately. A measure built as its own questionnaire (for example a STOP-BANG or SCOFF screen) gets its own score history and trend in the chart, which a few questions inside a long intake don’t.
Assign questionnaires to visit types
Rules live on the Visit Rules view. Depending on how your practice is set up, they belong either to each provider (Settings > Questionnaires) or to the practice as a whole (Admin > Questionnaires; see Practice-managed questionnaires). The editor is the same in both. A rule answers two questions: when to send (a visit is booked, on a recurring schedule, or the moment the patient registers for the portal) and which questionnaires to send. Optional filters narrow who gets them (age, sex, telehealth vs in-person, ICD-10 code on the problem list, preferred language, booking source, portal status, how far ahead the visit was booked, or when the patient was last seen).
- Open
Settings > Questionnaires(your own rules) orAdmin > Questionnaires(the practice’s), and stay on Visit Rules. Existing rules are listed on the left and the editor is on the right. If your practice manages questionnaires, a provider’s own page simply says Your practice manages questionnaire rules. - Click New to start a fresh rule, or pick an existing rule to edit. Existing rules show their status badge (Active, or Paused for a provider rule and Turned off for a practice rule), questionnaire count, and a one-line filter summary.
- Choose When. The When card has three choices: When a visit is booked (sends as soon as the appointment goes on the calendar), On a schedule (recurring — no visit required), and At patient registration (assigns and sends a reminder the moment the patient registers for the portal — no visit required). Pick When a visit is booked for the classic visit-type rule.
- Tick the Visit types and give the rule a Rule Name. Visit types is a list of checkboxes: "Sends when any checked visit type is booked." Tick every type that should get these questionnaires (for example all of your intake types) and use the age limits to pick adult or child forms. In
Admin > Questionnairesthe list shows the practice’s visit type names. A type that is no longer active reads "…" is not an active visit type anymore. with Remove it. Name the rule something you will recognize later (for example, "New patient intake questionnaires"). Set up visit types first if the list is empty. - Pick the questionnaires. Use Search questionnaire library... and check off the screeners you want. Selected items appear as removable pills at the top of the Send card. A practice rule can only send questionnaires that are available to the whole practice.
- Optionally send a packet too (practice rules). In
Admin > Questionnaires, the Send card also has Also send a packet. Choose one of your practice’s packets: its questionnaires are sent with the ones you checked, and its forms join the visit’s paperwork, due a day before the visit, exactly like the forms Previsit Paperwork assigns. Anything the patient already has open, or has signed and doesn’t need to sign again, is not sent twice. A rule can send a packet with no questionnaires checked, and the rule list shows it as Packet: …. Provider rules inSettings > Questionnairescan’t send packets. - Choose whether to message the patient. On a booking rule, Also text or email the patient a link right away starts off: the appointment reminders before the visit already ask the patient to complete them (one message per booking, however many questionnaires). On a scheduled rule, Text or email the patient a link when these are sent starts on and is recommended, because a scheduled send has no visit and no reminder mentions it (one message per patient, quiet hours respected; a parent gets it for a minor). When the rule’s packet puts a form in front of the patient, they get one You have forms to complete message for the forms and questionnaires together; clear the checkbox and the packet sends no message of its own either.
- Optionally skip repeats. On a booking rule, Skip a questionnaire the patient completed in the last … days (blank = Off, up to 3,650) leaves out a questionnaire done recently, and also one still waiting to be filled out from an earlier booking.
- Add optional filters under Only if (optional). Leave them blank to send for every booking of these visit types. Or narrow with any combination of: Minimum Age / Maximum Age, Visit Mode (Any / Telehealth only / In-person only), Only if booked within … days of the visit, Patient Sex (Female, Male, Other), Portal Status (Registered, Invited, not registered yet, Not invited), Preferred Languages, Booking Sources, and Problem List ICD-10 Codes. A scheduled rule also offers Only patients seen in the last … days (see below).
- Leave the Active checkbox on (or clear it to pause). It sits in the editor header row beside the rule name, not down with the filters. Pausing keeps the rule definition but stops new patients from triggering it.
- Click Create Rule (or Save Rule if editing). The footer explains when booking rules run: "Rules run when an appointment is booked, and again if its visit type, provider or time changes (questionnaires the visit no longer needs are withdrawn unless the patient started them). Visits already on the calendar before a rule is saved are not updated." To see what a rule actually did for one patient, open that patient’s Questionnaires tab and expand Why questionnaires were or weren't sent.
Admin > Questionnaires, a practice rule instead lists each visit type where pre-visit intake is off and at how many providers, with a Send even when pre-visit intake is off button that changes this for every questionnaire rule in the practice. The other two triggers never touch a visit type, so this check does not apply to them.
Recurring (scheduled) rules
Choose On a schedule in the When card when a questionnaire should recur on a cadence rather than ride along with an appointment — periodic PHQ-9 monitoring, an annual functional screener, a quarterly medication-adherence check.
- Click On a schedule. The description reads "Recurring, e.g. every 3 months — visits not required."
- Pick an interval. Four presets are offered — Monthly, Every 3 months, Every 6 months, and Yearly — or type your own value in the Every <n> days box. Custom intervals must be a whole number of days between 1 and 1095.
- Pick the questionnaires and save. A daily sweep evaluates scheduled rules across every active patient in the organization; there is no appointment involved, so patients receive the questionnaire whether or not they have anything booked.
- Limit it to patients you actually see. Only patients seen in the last … days (for example 180) skips people with no recent care: "Seen = checked in for a visit or has a finished note in that time. Leave blank to include every active patient, including people not seen in years."
Rules that fire at patient registration
Choose At patient registration when your intake screeners should reach a new patient the moment they get portal access, before anything is on the calendar. The choice describes itself: "Assign and send a reminder the moment the patient registers for the portal — no visit required."
- Click At patient registration. The Visit Type field disappears — a registration has no appointment to match against — and Rule Name widens to fill the row. Leave the name blank and Hero EMR saves the rule as New patient registration questionnaires.
- Pick the questionnaires. The Send card states what the patient will get: "These questionnaires are assigned as soon as the patient registers for the portal, and the patient gets one reminder listing them together with any registration paperwork."
- Narrow with patient filters if you want to. Minimum Age, Maximum Age, Patient Sex, Preferred Languages, and Problem List ICD-10 Codes still apply. Leave them blank to include every patient who registers.
- Save. The rule reads At patient registration in the rule list, and the editor footer repeats the one thing to remember: "Registration rules run when a patient completes portal registration — they don't apply to patients who are already registered."
Admin > Patient Registration. It happens once per patient: a second account linked to the same chart (a parent or caregiver, say) does not re-send anything. Patients who already had portal access when you switched the rule on are not back-filled — send those from the patient's chart with Send a questionnaire on the patient header's Questionnaires tab.
Visit Mode
Limit a rule to telehealth-only or in-person-only visits. Leave on Any for both. Booking rules only.
Only if booked within … days of the visit
A maximum, not a minimum, checked when the visit is booked: "a visit booked further ahead than this gets nothing. It does not send the questionnaires later." Saved rules read back as Within <n> days. Set it to 7 and a visit booked 30 days out never triggers the rule — use it for last-minute screeners, not for ones that need lead time. Booking rules only.
Portal Status
Restrict to Registered, Invited, not registered yet, or Not invited portal patients. Most rules leave this blank, and registration rules do not offer it at all.
ICD-10 Codes
Comma-separated codes that must appear on the problem list — e.g. F32.1, F41.1 for depression/anxiety screening.
Preferred Languages
Two-letter codes (e.g. en, es). Useful when you have language-specific instrument versions.
Booking Sources
Limit by the origin Hero EMR recorded on the booking. The canonical values are emr, patient_api, website, mobile_app, phone_agent, voice_agent, physician_api, admin_api, followup_workflow, and waitlist_claim. The match is exact (case-insensitive), so a made-up value like online silently makes the rule never fire. Booking rules only.
Intake worklist where an intake coordinator, MA, or nurse marks them reviewed, flags them for the provider, or sends them back to the patient.
Subscales in their response views. Read each available cutoff or criteria result and any incomplete-answer information alongside the total. See Reading a questionnaire card.Open the Previsit Paperwork manager
Previsit Paperwork is org-wide. One admin builds the consent forms, financial policies, and other documents patients sign, and every physician in the organization shares them. Hero EMR ships with a set of read-only starter templates you can duplicate as a starting point. The header of the workspace sums up the one rule to remember: "A form goes out automatically only while it's Live; an Off form goes out only when your staff send it."
- Sign in as an org admin or an office manager. Building and managing templates needs administrator access or the templates permission, which office managers have. For everyone else the Previsit Paperwork entry is not shown in the Admin menu, and the underlying template list refuses the request even if the page is reached directly. There is no read-only mode. Sending a form does not need this page: front-desk staff with patient-management permission use
Send a formon the patient’s Questionnaires tab or in a visit’sDetails. - Open
Admin > Previsit Paperwork. The Previsit Paperwork workspace opens as its own full-page tab, with a sidebar of templates and a large editor pane. The sidebar splits into Your templates (org-owned, editable) and Starter templates (read-only, duplicate to customize). Until you pick a template, the editor pane shows How it works in three steps: Pick a form, Choose who gets it, Turn it on. - Read the Live and Off pills. Each of your templates carries a green Live pill (with a pulsing dot) or a gray Off pill. The line under its name says who gets it while it's Live, such as "Every visit", "New patients", or "Every telehealth visit + portal sign-up", or reads "Not sent automatically" when it's Off. The Your templates heading counts them, for example "3 live · 2 off". Whenever any form is Off, an amber callout at the top of the list says so: "2 forms are off. Patients only get them when your staff send them. Open a form and click Turn on to send it automatically." Starters show a Starter badge and their document type instead.
- Browse the starter templates. Hero EMR includes vetted starters for HIPAA NPP, consent to treat, financial policy + AOB, telehealth consent, no-show / cancellation policy, photography consent, ROI authorization, controlled substance agreement, and more.
- Pick a starting point. Click any starter and use Duplicate to edit to copy it into Your templates, or click New template to start from a blank slate. A duplicate always arrives Off, and the banner says so: "It's off for now, so no patient gets it yet. Review the wording, then click Turn on at the top." It assigns nothing to anybody until you click Turn on (§2.6).
- Send a form on demand with Send to a patient. The sidebar's second button opens Send a form ("The patient signs it in the portal. No appointment needed."). Search the Patient by name, phone, MRN, or DOB, choose the Form, and click Send form; Hero confirms Sent "{form}" to {patient}. They will find it in the portal under Forms to sign. and offers Send another form. It lands in the patient's Forms to sign queue with no appointment attached. A chart with no date of birth can't sign forms in the portal, and the window says so. Sending by hand works whether a form is Live or Off; Off forms are listed with "(sent on request only)" after their name. Forms can also be ordered from inside an encounter so they show up alongside that visit's other orders. To send several forms and questionnaires at once, switch the window from One form to A packet and pick one of your packets.
Manage questionnaires for the whole practice, send them to someone else, and the youth screeners
Admin > Questionnaires (under Patient-facing) is the practice’s version of each provider’s Settings > Questionnaires: "Send questionnaires automatically and manage the practice's questionnaire library." Practice administrators and owners can open it, and so can staff with the templates permission (office managers have it). Its left rail has Visit Rules, Library, Packets (below), Someone else (below), and Advanced (campaigns, simulator, previsit-bot settings, and activity).
Who sets the visit rules: Defer to individual providers?
- Choose Yes or No. "Yes: each provider sets this in their own Settings → Questionnaires. No: the practice sets it here for everyone, and providers don't see these options." Practices that were already using Hero before this choice existed start on Yes; new practices start practice-managed (No).
- Read the consequence before saving. Switching to No says how many provider rules will be paused: "… provider rules will be paused while the practice manages questionnaires. Switching back restores them."
- Click Save questionnaire settings. It confirms Questionnaire settings saved.
- Practice-managed (No). Practice rules run for every provider’s visits, on every trigger. Providers’ own rules are listed under the rule form (Providers' own rules (N) — paused while the practice manages questionnaires); Use for the whole practice turns one into a practice rule. Removing a practice rule is Deactivate Rule; questionnaires already assigned stay in patients’ charts.
- Deferring to providers (Yes). Booking rules are set by each provider ("Rules that run when a visit is booked are set by each provider while 'Defer to individual providers?' is Yes."), and a booking rule the practice made earlier shows "This booking rule is paused while providers manage their own visit rules."
- Rules with advanced conditions (made in Advanced) are shown read-only in the editor with Open Advanced.
The practice library
In Library, a questionnaire one person built reads Personal — practice rules can't send it until an administrator clicks Make available to the practice; it then reads Practice. Remove from the practice asks "Remove from the practice? Rules can no longer send it." and is refused while an active rule, an open campaign or a recurring enrollment still sends it, so nobody’s automation changes silently.
Packets: build each form once, send them together
A packet is a named, ordered group of forms your practice already has: Previsit Paperwork forms (consents, releases, details forms) and questionnaires (your own or Hero’s standard screeners). Build each form once in its own editor, then group them, for example Packet 1: screening, details, consent and Packet 2: clinical. A packet points at the forms; it never copies them, so a form you edit is edited in every packet, and you can make a new packet from the same forms at any time.
- Open
Admin > Questionnairesand choose Packets. Your packets are listed on the left with how many items each has, how many are unavailable, and whether a Visit Rule sends it. - Click New packet and give it a Packet name. Staff and patients see the name. The Description is for your staff (when to send it).
- Add the items. Add a form lists every published Previsit Paperwork form, including forms that are Off (sent on request only). Add a questionnaire lists the questionnaires the whole practice can use; a personal questionnaire can’t go in a packet until it is made available to the practice. Each form can be in a packet once.
- Put them in order. Use the up and down arrows; the patient sees them in this order. The × removes an item from the packet (the form itself is not deleted).
- Click Create packet (or Save packet). Delete packet removes the packet, never its forms; patients keep anything already sent. A packet a Visit Rule sends can’t be deleted until it is removed from that rule.
Send a packet from the chart’s Questionnaires tab (Send a form → A packet, or Send Questionnaire → Send a packet), from a visit’s Details, or from a patient conversation in the Inbox (Packet). Choose the packet, untick anything this patient doesn’t need, and click Send packet. Each item goes out exactly as it would on its own (sent from a visit, it is linked to that visit). Anything the patient already has waiting is not sent twice: it reads Already waiting and counts as part of the packet. A form whose boxes your office fills in first (a procedure consent, say) is left out with a note to send it on its own with Send a form. The patient gets one message for the whole packet, sent within quiet hours, and finds its items together in the portal under the packet’s name with how many are done. Each completed item is still saved on its own: signed forms in Media under Paperwork, questionnaire answers under Patient Info > Questionnaires. To send a packet automatically, name it in a practice Visit Rule (§2.3).
Send questionnaires to someone else (a teacher, spouse or other informant)
Some scales are answered by someone who knows the patient: a Vanderbilt teacher form, or a spouse’s or other parent’s rating. Hero can send them a secure link instead of a paper form you scan into the chart. It is off for every practice until an administrator turns it on.
- Turn it on. In
Admin > Questionnaires, choose Someone else and switch on Let staff send questionnaires to someone other than the patient (a teacher, spouse or other informant). It saves straight away. - Send from the chart. On the patient’s Questionnaires tab,
Send Questionnairenow starts with Send to:The patientorSomeone else. ChooseSomeone else, then fill inTheir name,Relationship tothe patient (Teacher, Spouse or partner, Parent or guardian, or Other, which asks you to describe it),Emailand, if you like,Mobile (optional). Tick up to 5 questionnaires. - Confirm the patient agreed. Tick “{first name} (or their parent or guardian) agreed to share this questionnaire and its answers with this person.” and press
Send. It confirms Sent to Ms. Jones, teacher.
- What they get. An email with a secure link (and a text when you add a mobile, sent only from your practice’s own texting number and never to a number that replied STOP). The message names your practice and “a patient of ours”, nothing else. The link works until they send their answers, for up to 14 days.
- They confirm who they are. The page shows your practice’s name and asks for Your email address: the address you sent it to. Only then do they see the patient’s first name and last initial and the questionnaires. Five wrong tries lock the link for 15 minutes; ten stop it working.
- Where the answers go. On the patient’s chart, scored like the patient’s own and labelled with who answered, for example Completed by Ms. Jones, teacher. Score trends show them as their own line, marked with the relationship (for example (teacher)), never mixed with the patient’s. The patient and their portal never see these questionnaires or the answers, and patient reminders and rules ignore them.
- Follow up. The Questionnaires tab lists each send under Sent to someone else with its state (Waiting, Completed, Cancelled, Link expired or Link locked).
Resendsends a new link, good for another 14 days;Cancelasks Cancel this send? The link stops working. (Cancel sendorKeep it).
Staff who can send questionnaires to patients can send to someone else. Sends are refused while your practice’s patient messages are turned off.
Youth screeners: DASS-Y and PHQ-A
Two youth screeners are in the standardized library for every practice, ready to add to a rule (use the age limits to send them only to young patients):
| Questionnaire | Ages | Scoring |
|---|---|---|
DASS-Y — Depression Anxiety and Stress Scale - Youth | 8–17 | 21 items about the past week, answered from Not true to Very true. Depression, Anxiety and Stress subscales, each banded Normal, Mild, Moderate, Severe, Extremely severe; total 0–63. |
PHQ-A — PHQ-9 Modified for Adolescents | 11–17 | Nine items about the past two weeks, scored 0–27 with the PHQ-9 bands (Minimal depression to Severe depression), plus four unscored extra questions. Any answer above zero on item 9, or Yes to either safety question, raises the same safety flag as the PHQ-9: a chart alert, safety to-dos, and crisis help in the portal. |
Patients see each standardized questionnaire’s own time frame above its questions (for example "During the past two weeks, how often have you been bothered by:"). Patient lists can find patients by their latest PHQ-A or DASS-Y result (see Custom search builder).
Child anxiety and ADHD follow-up: SCARED and the Vanderbilt follow-ups
Four more scales are in Hero’s library for every practice. Search SCARED or Vanderbilt in Send Questionnaire, or add them to a rule. Each is scored on the chart like any other questionnaire.
| Questionnaire | Who answers | Scoring |
|---|---|---|
SCARED Child — Screen for Child Anxiety Related Disorders (SCARED) - Child Version | The child, ages 8–18 (children 8–11 with an adult or the clinician explaining) | 41 items about the last 3 months, each Not True or Hardly Ever True (0) to Very True or Often True (2); total 0–82. 25 or more may indicate an anxiety disorder; above 30 is more specific. Subscales with their cutoffs: panic disorder or significant somatic symptoms (7), generalized anxiety disorder (9), separation anxiety (5), social anxiety (8) and significant school avoidance (3). |
SCARED Parent — Parent Version | The parent, about the child | |
Vanderbilt Parent Follow-up — NICHQ Vanderbilt Assessment Scale - Parent Follow-up | The parent | For monitoring ADHD treatment, about behavior since the last rating. Total symptom score 0–54 from the 18 ADHD symptoms (items rated Often or Very Often are counted for the inattentive and the hyperactive/impulsive subscales), an Average performance score from 8 performance items (a 4 or 5 shows impairment), and 12 side effects in the past week, which are not scored; one rated moderate or severe is listed with the result. |
Vanderbilt Teacher Follow-up — Teacher Follow-up | The teacher, about the classroom |
To have a teacher fill in the teacher form, send it to them with Send questionnaires to someone else.
Delete or cancel a questionnaire sent to a patient
To delete, cancel, or remove a questionnaire assignment that went to a patient by mistake, cancel it from the patient’s chart. Hero EMR never deletes a questionnaire record: a cancelled one stays in the chart marked Skipped, and a completed one stays as it was submitted.
- Open the patient’s chart and the
Questionnairestab. Scroll toPrevious & upcomingand filter toUpcomingif the list is long. - Find the row marked
Sent — awaiting completionand clickCancel. TheCancel questionnairewindow explains “The patient will no longer see this questionnaire. It stays in the chart marked Skipped.” - Confirm with
Cancel questionnaire(or back out withKeep it). The questionnaire leaves the patient’s portal.
| What you see | Can it be cancelled? | What to do instead |
|---|---|---|
Sent — awaiting completion, not started | Yes, with Cancel. | — |
| The patient has started it | No. Hero refuses: “Could not cancel this questionnaire. The patient may have just started it. Refresh and try again.” | With Social needs screening turned on in Admin → Additional Features, Patient declined closes an open questionnaire as Declined. |
Scheduled (dashed border) | Not a real assignment yet; it is the next send a recurring rule will make. | Pause or delete the patient rule on the same tab, or add a Stop automatic sending rule to block a practice rule for this patient. |
Completed | No. Completed answers cannot be deleted or edited. | Document the correction in the visit note. |
Withdrawn (visit changed) or Withdrawn (visit cancelled). To stop a rule sending to new visits, pause it on Visit Rules (Assign questionnaires to visit types). Cancel needs patient-management permission; see the Questionnaires tab for the full tab.Add a questionnaire such as AIMS to a visit without sending it to the patient
Hero EMR has no way to attach a questionnaire to a visit for the clinician to fill in without it also going to the patient. Every questionnaire you add from the chart or a rule is sent to the patient (or the parent or guardian for a minor) through the portal, with a reminder by their notification preferences. The AIMS (Abnormal Involuntary Movement Scale) and other clinician-scored scales are not in the standard questionnaire library.
Supported ways to record a clinician-scored scale:
- Record it in the note. Put the scale in a note template or a dot phrase so it is part of the visit’s documentation (see Note templates and dot phrases).
- Or enter a sent questionnaire’s answers in the office. With
Social needs screeningturned on inAdmin → Additional Features(off by default), an open questionnaire the patient has not started offersFill in with patienton the chart’sQuestionnairestab. Enter the answers and clickSave answers; they are scored and charted like a portal submission and markedby staff. The questionnaire must still be sent first, so the patient is notified, and it must be in your library (your practice can build its own inLibrary).
Why subscale scores aren’t showing
A Subscales breakdown (each domain’s score, cutoff, and interpretation) appears only when the questionnaire’s scoring defines subscales and the response was scored with them. If you expected subscale scores and see only a total, check these in order.
- Does the questionnaire have subscales at all? Most standard screeners score a single total (PHQ-9, GAD-7 and the like have no subscales). In the standard library, the PCL-5 and the DASS-Y score subscales.
- Is it your practice’s own questionnaire? A questionnaire you built or copied has subscales only if its scoring setup defines them, under Advanced: edit as JSON in the questionnaire editor’s scoring section in
Library(see Build a questionnaire). Hero EMR support can set this up with you. - Was the response completed before the subscales were added? Scores are saved when the patient submits. Changing a questionnaire’s scoring later does not re-score earlier responses, so older responses have no breakdown. A missing subscale is not a zero.
- Was it brought in from another system? Imported historical scores keep the total they arrived with and have no subscale breakdown.
- Were the domain’s questions answered? A subscale with none of its questions answered shows no score.
- Can your role see scores? Staff without intake review or visit-note access see that a questionnaire was completed but not its answers or scores.
Where the breakdown appears: the note’s Questionnaires pane (Reading a card), the patient’s questionnaire history on the chart’s Questionnaires tab, and questionnaire details inserted into a note.
Remind patients to finish questionnaires and forms (Paperwork Reminders)
Paperwork Reminders sends patients, or the parent or guardian for a minor, reminders while questionnaires or intake paperwork are still incomplete. It is on for every practice unless turned off, starting with steps before each visit at 6:00 PM. Practice administrators and office managers change it.
- Open
Admin → Schedulingand choosePaperwork Remindersunder Reminders. - Keep the
Paperwork remindersswitch on (turn it off to stop all paperwork reminders). - Set each step’s timing. Pick a preset (for example 1 week before visit at 6:00 PM, Day before visit at 6:00 PM, Morning of visit at 8:00 AM, or 2 days after paperwork is sent at 10:00 AM) or
Custom: chooseBefore the appointment(days before the visit) orAfter paperwork is sent(days after it was sent, which also covers questionnaires sent without a visit), and a send time. - Choose which visits a before-the-visit step covers:
Every visit,Only these visit types, orEvery visit type except. - Pick the delivery methods:
SMS,Email,Push. Each step needs at least one. Optionally writeCustom SMS text (optional)orCustom email subject & body (optional), and usePreview messageto see it with your practice’s real name, branding, and portal link. - Add or remove steps with
Add Reminder(up to 12) and the remove button on each step, then save. Hero confirms “Paperwork reminder policy saved. The next reminder sweep uses it.”
Patient Notifications are separate (Patient notifications).A questionnaire shows as sent but isn’t in the patient’s portal
When the chart says a questionnaire was sent and the patient says it isn’t in their portal, open the patient’s Questionnaires tab and check the row, then work down this list.
| What you find | Why the patient doesn’t see it | What to do |
|---|---|---|
The row reads Scheduled with a dashed border | It has not been sent yet. It is the next send a recurring rule will make (Next around…). | Wait for the date, or send it now with Send Questionnaire. |
Skipped, Expired, or Withdrawn (visit changed) / Withdrawn (visit cancelled) | It is no longer open, so the portal no longer lists it. | Send it again with Send Questionnaire. |
| The patient is a minor or a parent-managed teen | Questionnaires go to the parent or guardian’s portal account, not the child’s. | Ask the parent to sign in with their own account and look at the to-do list on the portal home. |
| The visit was hidden from guardians | Your practice’s guardian settings can hide questionnaires from hidden visits. A guardian cannot see or complete them. | An eligible teen completes it with their own sign-in, or staff hand them the office kiosk (Teens & guardians). |
| The patient signs in with another account or email | They are looking at a different portal sign-in, or have no portal account yet. | In Admin → Patient Registration, open Portal access and check Current access. Send an invitation if there is none, or fix the sign-in email (Change a patient’s sign-in email). |
Open questionnaires appear in the to-do list on the patient’s portal home, each with a due date or Complete at your convenience.
Change or turn off the pre-visit interview (AI Pre-visit Chat)
The pre-visit interview is the AI chat patients complete in the portal before a visit. It is turned on or off per visit type. Your practice does not edit the chat’s own questions; to ask patients specific questions before a visit, send questionnaires with questionnaire rules.
- Open the visit type. In
Admin → Scheduling, openVisit Configfor a provider’s visit types orPractice visit typesfor the practice’s (Visit types). - Under Options, tick or clear
AI Pre-visit Chat. It sits underRequires Pre-visit Tasksand is only available while that is ticked; clearingRequires Pre-visit Tasksalso turns the chat off. The visit type card reads AI pre-visit chat: with its state. - Save the visit type.
Admin → Questionnaires → Advanced, Previsit Bot Assignment controls whether the interview may recommend extra questionnaires for the patient (Enabled), only for first-time patients (New Patients Only), and how many at most (Max Assignments (Previsit Bot)). An unfinished interview blocks the patient’s own portal check-in and telehealth join, like an unfinished questionnaire; staff can still check the visit in from the EMR.Need help? Email support@heroemr.com.