The ScribeMD handbook
Your guide to ScribeMD
From your first recording to a workflow that feels like yours. Follow clear, practical guides with screenshots at every step.
No matching guides
Try a feature name, such as templates, dictation or team.
Getting around
ScribeMD has two navigation areas you will use constantly:
- The left rail (icons down the left edge): + starts a new visit, then My Visits, Patients, Comm Hub, Answers and Templates. At the bottom sit the light/dark toggle, the ⚙ Settings gear and your avatar.
- The settings menu: click the gear to open My Account. A second column appears with everything else, grouped as Account, Clinical, Team & Organization, Productivity and Integrations & Billing. Most chapters below start from this menu.
Some items are only visible to organization admins (Organization Settings, Medical Team, Surveys, API Key, Subscriptions); members with Developer access also see API Key. If you cannot see one of them, ask your admin.
Safe use and limitations
ScribeMD records a consultation or your dictation, transcribes it and drafts notes and letters for you to review. Everything it writes is a draft: it does not replace your clinical judgement, and it is not for use in emergencies.
You stay responsible for the record
- Read every note and letter before you use it, and compare it with what was said. Correct anything wrong or missing.
- Take particular care with drug names, doses, negatives ("no chest pain"), left and right, and numbers.
- Check that the note belongs to the right patient before you copy it into their record.
- Do not rely on ScribeMD to have captured something. If it matters and it is not in the note, add it yourself.
Known limitations
- Accuracy drops with background noise, people talking over each other, a distant microphone, strong accents, speech impairments and mixed languages.
- ScribeMD can mishear a word, attribute a statement to the wrong person or record something hypothetical as fact.
- It only knows what was said or what you gave it. It can leave details out and, rarely, add something that was not said.
Telling patients
Tell patients at the start that ScribeMD will record and transcribe the consultation to draft their notes, and that they can say no. If a patient objects, do not record: write the notes yourself.
Your organization may switch off some features (such as Answers or Co-Pilot suggestions), ask you to approve each note before it is sent to another system, or ask you to confirm that you told the patient before each visit. These settings follow your organization's clinical safety and information governance decisions.
Found an error that could affect patient care? Report it through your organization's incident process and to us at support@scribemd.ai.
Record a visit and generate a note
This is the core workflow: ScribeMD listens to the consultation, transcribes it, and writes the clinical note from your chosen template. You stay with the patient.
Start the visit
- Click the blue + button at the top of the left rail. The visit setup screen opens with your microphone level meter at the top.
- Check that the right microphone is selected and the meter reacts when you speak.
- Pick the spoken language of the visit and the note template you want (your default is preselected).
- Optionally open Patient Details to attach a patient, and Consultation Context to paste anything the AI should know (referral reason, previous results).
- Click Start Consultation. If you already have an audio file, use Upload Audio instead.
During the recording
- Telehealth call? Click the headset icon next to the settings gear and pick the browser tab with your call, keeping Also share tab audio on. A green Call audio on badge confirms the patient's side is being captured.
- The timer runs and the waveform confirms audio is being captured. Do not reload the page while recording.
- Type anything you want included in the note into Physician Notes (vitals, exam findings, your assessment). It autosaves.
- Use Pause for interruptions, then resume.
- When the visit is over, click Generate Note. ScribeMD processes the audio and writes the note; this usually takes well under a minute.
Review, edit and export the note
- The note opens on the Notes tab, structured by the sections of your template. Rename the visit with the pencil next to its title.
- Click Edit to change any section, then Save. Click Copy to put the whole note on your clipboard for your EHR.
- The Transcription tab shows the full, speaker-labelled transcript. The Documents tab generates letters and forms from the visit (see chapters 4 and 5).
- The ⋮ menu holds everything else: Download PDF or Word, Duplicate, Resume the visit, Generate Billing Code, Regenerate, Note history, Share Note and Delete.
- Use the thumbs up / down at the bottom right to rate the note. Feedback improves future notes. Rate it as often as you like, or highlight a passage to comment on just that part. To correct a passage, highlight it, click thumbs down, say what is wrong and choose Submit & Regenerate — only that passage changes (plus any place that repeats the same fact) and the changed words light up. If the correction can't be applied to that passage, Scribe says so and offers to regenerate the whole note (this replaces manual edits).
Tip. All visits are listed in the Visits panel next to the rail, grouped by Today, Yesterday and Older. Use the search box to find a visit by name.
Dictate a note
Dictation is for when you speak the note yourself, after the patient has left or between visits. ScribeMD transcribes live and cleans the dictation into your template. Dot phrases (chapter 6) expand as you speak.
- Open the chevron under the + button and choose New Dictation. If dictation is your default visit type, the + button opens it directly.
- Check the template shown top right (your default is preselected) and give the dictation a title if you like.
- Click Start Recording and speak. Your words appear in Live Transcript on the left.
- Click Pause to stop, and Generate Note to turn the transcript into a structured note on the right.
- To dictate directly into a section of the note, place the cursor in the note and click Dictate. The text is inserted at the cursor.
Dictate anywhere with the desktop app
The ScribeMD desktop app lets you hold a shortcut key, speak, and have clean text pasted into whatever application is in front of you, including your EHR. Its settings live in the web app under Settings › Productivity › Desktop app and follow your account to any computer.
Tip. The Dictation model and Dictation cleanup prompt in My Account (chapter 9) control how your dictations are tidied. Leave them on the defaults unless you have a specific need.
Tip. Dictating during a telehealth call? Click the headset icon next to the settings gear and pick the call's browser tab to capture both sides. The settings gear has a step-by-step guide.
Note templates
A note template defines the sections of your note and the instructions the AI follows for each one. ScribeMD ships with official templates; you can build your own by hand or with AI, share them with your organization, and set one as your default.
Create a template by hand
- Click Create Template.
- Choose Simple (a single free-text SOAP section) or Advanced (multiple sections you fully control).
- Optionally copy an existing template as a starting point, give it a name, and pick a folder.
- Leave Make private on to keep it to yourself, or turn it off to share it with your organization. Click Create.
Edit sections and instructions
- Each section has a name, an instruction block telling the AI what belongs there, a Required toggle and a style (bullets, numbered, dashes, no bullets, narrative).
- Drag the handle on the left to reorder sections; use the trash icon to remove one.
- Add sections with Create Section on the right, or pick from the Predefined Sections library. It includes ready-made Problem List and Medication Reconciliation sections.
- Scroll down for Custom Instructions that apply to the whole note, then click Save Changes.
- Use Test template at the top to run the template against one of your past visits before using it live.
Create a template with AI
- Click Create with AI in the banner at the top of the page. Describe the template in plain language, or paste an example of a note written exactly the way you want it. Prefer to build it section by section? Click Advanced.
- Click Send. The builder drafts a full template and shows an Example note next to its Structure.
- Refine it by typing what to change in the box at the bottom ('add a medications section', 'make the plan a numbered list').
- When you are happy, click Create Template. It lands in My templates and can be edited like any other.
Set a default template
- Open My templates and click Make Default on the template's row.
- Choose Make my default. Admins can also choose Make default for organization (not available for private templates).
- The default template is preselected on every new visit and dictation. You can still switch templates per visit.
Tip. You can also set your default under My Account › Note Template (chapter 9), and admins can restrict which templates a department sees under Departments.
Document templates
Document templates turn a finished visit into a letter or report: referral letters, sick notes, discharge summaries, patient instructions. You write the layout once with placeholders; ScribeMD fills it from each visit.
Create a document template
- Open the settings gear, then Document Templates in the Clinical group, and click New Document Template. The form opens in a new browser tab.
- Give it a Name. Tick Make this an organization template if colleagues should be able to use it.
- In Instructions for AI, explain what the document is for and how it should be written (tone, what to include or leave out).
- Write the Content in the editor. Use square-bracket placeholders such as
[PATIENT_NAME],[DATE]or[REASON_FOR_REFERRAL]where the AI should insert visit-specific text. - Click the create button at the bottom. The template appears under My Templates or Organization Templates.
Generate a document from a visit
- Open the visit and switch to the Documents tab. In the dictation recorder, open the ⋮ menu above the note and choose Documents instead.
- Click Generate Document and pick a template from the list (search if you have many). PDF templates appear in the same list with a PDF label.
- ScribeMD writes the document from the note and transcript. Download it, or open it to make changes.
Tip. A template that has already been used to generate documents cannot be deleted. Edit it instead, or create a new version.
PDF templates
PDF templates are for official forms that must keep their exact layout: insurance forms, ministry reports, procedure reports. Upload a fillable PDF, tell ScribeMD what each field means, and it fills the form from the visit.
Upload a fillable PDF
- Open PDF Templates under the settings gear and click New PDF Template.
- Choose the PDF file. It must be a fillable PDF (one with form fields). Field detection starts immediately.
- Optionally give the template a Name, then click Create Pdf template. ScribeMD reports how many fields it found and opens the editor.
Describe the fields
- Use General context to describe the form as a whole (who fills it, in which situation). This context is shared with the AI for every field.
- Fields are drawn over the PDF preview. Click one to select it, then set its Name, an Instruction explaining what should go there, and the font size.
- Missing fields can be added by dragging a Text, Checkbox, Signature or Date tool from the palette onto the page. Use Prev / Next for multi-page forms.
- Save. The template now shows under PDF Templates and in the Generate Document list of every visit (chapter 4).
Tip. If your form is a Word document or a scanned PDF, it needs to be converted into a fillable PDF first. Contact support and we can prepare it for you.
Dot phrases
A dot phrase is a short trigger that expands into a longer block of text you use often: a normal exam, return precautions, counseling you give every time. Say the trigger while dictating, or type it in the note editor, and the full text is inserted.
Create a dot phrase
- Open Dot Phrases under the settings gear. Your existing phrases are listed with their triggers.
- Click New Dot Phrase.
- Give it a Title for your own reference, a short unique Trigger (the words you will say or type), and the Content to insert. Content can include placeholders such as
[DATE]. - Click Create Dot Phrase. Use the pencil and trash icons on each row to edit or delete later.
Use a dot phrase
- While typing. Open a note in edit mode (Edit on the visit page, or any note or template editor), place the cursor where the text should go and type a period followed by the trigger, for example
.return precautions. - Press Space, Tab or Enter. The trigger is replaced by the full content of the phrase. Keep typing, or click Save when the note is done.
- While dictating. Just say the trigger words (“return precautions”) where the text belongs. The expansion is applied when the dictation is transcribed, so the finished note contains the full text, not the trigger.
- In generated notes. When ScribeMD writes a visit note, it knows your phrase book and inserts the matching phrase word for word wherever the trigger was said during the visit.
Tip. Dot phrases are personal. If your whole team uses the same standard text, each person creates their own, or an admin can bake the text into a note template section instead.
Custom keywords (your dictionary)
If the transcript keeps misspelling a drug, a colleague's name, a device or a local place name, add it as a custom keyword. Speech recognition then favours your spelling. Keywords apply to both visits and dictations.
- Open Custom Keywords under the settings gear.
- Type the term exactly as it should be written and press Enter (or click +). It is saved immediately.
- Open Show Terms to review the list; use the search box when the list grows. Click – next to a term to remove it.
What to add. Brand-name drugs, surnames, clinic and hospital names, abbreviations you use out loud, and any term the transcript gets wrong more than once. Up to 100 terms per language.
What not to add. Common words, or long phrases. For boilerplate text use a dot phrase (chapter 6). Admins can also set department-wide keywords under Departments.
Change languages
ScribeMD has three separate language settings, and it helps to know which is which. All three live on the My Account page.
| Setting | What it controls | Example |
|---|---|---|
| Default Visits Language | The language spoken during the visit, used for transcription. Can be changed per visit on the setup screen. | A clinic in Montréal where consultations happen in French. |
| App Language | The language of the ScribeMD interface: menus, buttons, settings. | Show the app in Français, Español, עברית, 日本語 and more. |
| Note Language | The language the generated note is written in, regardless of the language spoken. | Visit in Arabic, note in English for the chart. |
- Click the settings gear. My Account opens.
- Scroll to the language fields and choose the value you need from each dropdown.
- Scroll to the bottom and click Save Changes. The interface switches immediately when you change the app language.
Tip. Admins set the organization's Default Notes Language under Organization Settings. A user's own Note Language overrides it.
Personal settings
My Account holds everything about how ScribeMD works for you. Change what you need, then click Save Changes at the bottom of the page.
| Group | Settings |
|---|---|
| Profile | Full name, email, phone number, healthcare role. |
| Languages | Default visits language, app language, note language (chapter 8). |
| Recording | Dictation model, default new visit (Consultation or Dictation), transcription service, default visit mode (in person / telehealth). |
| How notes are written | STT context (background terms for speech recognition), dictation cleanup prompt, custom prompt (instructions applied to every note), default note template. |
| AI settings | Optionally override the organization's AI provider and model for your own notes. |
| Hardware | Enable a Philips SpeechMike. |
| Letterhead | A header (logo, address) prepended when you copy or download notes. |
| Password | Change your password, or request a reset link. |
Light and dark mode
Click the moon / sun icon at the bottom of the left rail to switch themes. The choice is remembered on your account.
Keyboard shortcuts
Under Settings › Productivity › Keyboard Shortcuts you can enable shortcuts for starting and stopping dictation, generating the note, copying to the clipboard and clearing the recorder. Turn a shortcut on, pick the key combination, and save.
Organization settings (admins)
Admins also see Organization Settings: the clinic name and address, the patient consent text and whether consent is required before recording, the organization's default note language, and the AI provider used for the whole team.
Invite your team
Admins and department admins can invite colleagues by email. Invited users join your organization, inherit its templates and settings, and appear on the Medical Team page where you manage roles.
- Open Medical Team under the settings gear, or click Invite Team Members from your avatar menu at the bottom of the rail.
- Click Invite Team Members. Type or paste email addresses; separate them with a comma, space or new line. Each address becomes a chip.
- If your organization uses departments, tick the departments the new users should join.
- Click Send Invitations. Each person receives an email with a link to set their password.
- The confirmation dialog also shows each invitation link. Use Copy link to send it yourself if an email is delayed or blocked by a spam filter.
Roles and departments
- Change a member's role with the Role dropdown on their row: User for clinicians, Admin for people who manage templates, settings and billing.
- Give a member Developer access with the code icon in their row's Actions (admins only): whatever their role, they can then manage the organization's API keys.
- Create departments under Departments to group members (for example by discipline or site). A department can have its own note templates, keywords and custom instructions.
- Remove a member with the trash icon on their row. Their visits remain in the organization.
Tip. Individual accounts are free. Organizations on an Enterprise plan manage seats under Subscriptions; contact your account manager to add seats before inviting a large group.
Clinical guidelines
Clinical guidelines turn an official guideline PDF (Lung-RADS, Fleischner, TI-RADS…) into a decision table ScribeMD can follow. Attach a guideline to a note template and every note written with it is checked against the guideline: when the visit documents what the guideline needs, the matching recommendation is added to the note, with the reasoning one click away.
Browse the guideline library
- Click Guidelines in the left rail. The library lists every guideline you can use, with its version.
- Official guidelines are published by ScribeMD for everyone; Organization guidelines were added by your organization's admins.
- Use the search box to filter by name, and click a guideline to open it.
Add a guideline from its PDF (admins)
- In the library, click Add Guideline.
- Enter a Guideline name and choose the Official guideline PDF. Text-based PDFs work best; scanned documents may not extract reliably.
- Click Upload & Extract. ScribeMD reads the PDF and extracts the guideline's required inputs, decision logic and possible outputs. This takes a minute or two.
- On Review extraction, compare the original PDF on the left with the extracted logic on the right. When it matches, click Save & Activate. If something is wrong, click Report an Issue instead.
- Once active, a guideline is read-only and available to everyone in your organization. Corrections are published as a new version, never by editing the active one.
Use a guideline in a note template
- Open the note template (chapter 3) and scroll to Clinical Guidelines: below the sections.
- Search for the guideline and select it. You can attach several.
- Optionally add instructions for each guideline, for example how short the recommendation should be or what to leave out.
- Click Save Changes. From now on, every note generated with this template is checked against the guideline.
- To write the result inside the sections that mention the guideline (for example a grade in Findings and the next step in Plan), tick Use the results within the sections and refer to the guideline in those sections' instructions. A result that fits no section is still added under Recommendations at the end of the note. Without this option, the recommendation always goes under Recommendations.
Apply a guideline to the whole organization or a department
- Admins: open Organization Settings and scroll to Clinical guidelines. Department admins: open Departments, pick the department and open its Clinical guidelines tab.
- Select the guidelines and, if you like, add instructions for each one. Click Save Changes.
- From then on every note is checked against the organization's guidelines, those of every department its author belongs to, and the template's own. A guideline attached at several levels runs once, with all its instructions.
- On a template where they don't fit, such as a patient letter, tick Don't apply organization and department guidelines under Clinical Guidelines.
See the recommendation in the note
- Record or dictate as usual with that template. Once the note is written, the guideline is evaluated; the note shows Applying clinical guideline… while it runs.
- When the note contains everything the guideline needs, the recommendation is added under Recommendations, tagged with the guideline's name and version.
- The Clinical guidelines card under the note lists the values that were read, such as nodule size and type. If something the guideline needs is not documented, the card says so and no recommendation is added.
- Click View decision table to see each input with the exact quote from the note or transcript, and every step of the decision path that led to the result.
- With Use the results within the sections, the guideline is evaluated before the note is written and each phrase taken from it appears where the template asks for it, tagged with the guideline's name. Results that fit no section, including organization and department guidelines, are added under Recommendations at the end.
Recommendations are drafts. Like the rest of the note, check them against your clinical judgement before signing. If a value is missing or wrong, fix the note and regenerate to evaluate again.
Don't see Guidelines in the rail? Clinical guidelines are switched on per organization. Ask your admin or your ScribeMD contact.
Spotted an error in a guideline? Open it and click Report an Issue. The ScribeMD team reviews every report.
Summarize a patient's chart
Before a follow-up, read the patient's story in one place. Summarize Encounters reads every visit attached to a patient and writes a single chart summary: a table of previous sessions (clinician, date and action taken), the event that brought the patient in, and a summary of the notes without the assessment and plan.
Generate the summary
- Click Patients in the left rail and choose the patient from the list. The search box finds them by name.
- Check History of Encounters on the right: these are the visits the summary reads. A visit is listed here once the patient is attached to it (chapter 1).
- Click Summarize Encounters at the top right. The button stays greyed out until the patient has at least one visit.
- The summary is written into Clinical Notes as it is generated, starting with the previous sessions table. You can leave the page: it keeps going and is there when you come back.
Review and use it
- Check the summary against the notes it comes from: click a visit under History of Encounters to open its note.
- Once a summary is ready, Ask ScribeMD becomes available next to the button, so you can ask questions about the whole chart.
- Seen the patient again since? Click Summarize Encounters again. The new summary replaces the previous one.
The summary is a draft. It is written by AI from your notes and can leave things out or get them wrong. Check dates, doses and results against the original notes before you rely on it or copy it into a record.
Seeing Failed to generate notes. Please try again.? Click Summarize Encounters again. If it keeps failing, contact support.
Can't summarize a colleague's patient? Only the clinician the patient belongs to, or an organization admin, can generate the summary.