River
Y CombinatorBacked by Y Combinator

HealthcareFree tool

SOAP Note Generator From Visit Notes

A SOAP note from your own visit notes: an assessment and plan for each problem, only what you documented, and a list of gaps to confirm.

Helpful to include

Free to start · Opens in your River workspace, ready to edit and share

How to write a SOAP note

A SOAP note documents a patient visit in four parts: subjective, objective, assessment and plan. Subjective is what the patient tells you, and objective is what you observe, measure and test. The assessment gives your judgment on each problem, and the plan says what happens next for each one. A good SOAP note records only what happened, shows the reasoning behind each decision, and lets the next clinician continue care without calling you.

Spend most of your words on the assessment and plan. The first two parts are the evidence; the last two hold the reasoning and decisions the next clinician acts on.

A doctor in a white coat and stethoscope writes on a clipboard while a patient sits across the desk, a laptop open beside him
Many notes start as shorthand jotted while the patient talks. Photo: Vitaly Gariev on Unsplash

What goes in a SOAP note

In the US, the Centers for Medicare & Medicaid Services (CMS) sets out what each visit's record should hold. Its guide lists the reason for the visit and relevant history, exam findings, prior test results, your assessment, and the plan of care1. SOAP arranges them in the order you gather them.

The four parts of a SOAP note

PartWhat it holdsWatch for
SubjectiveChief complaint, history of the present illness, relevant past history, medications and allergiesExam findings slipping in, or last visit's review of systems
ObjectiveVital signs, the exam you performed, and test results with their datesNormal findings for systems you didn't examine
AssessmentEach problem you addressed, its status, and the findings behind your judgmentDiagnoses listed with no status or reasoning
PlanFor each problem: tests, medicines, referrals, advice given and follow-upOne long list no one can match to a problem

Start with the patient's story

Open with the chief complaint. CMS describes it as a short statement of the symptom, problem, condition, diagnosis or reason for the visit1, usually in the patient's own words. Quote them when the words matter: "I get winded on the stairs" tells the reader more than "dyspnea on exertion."

Then write the history of the present illness. Cover when it started, where it is, what it feels like, how severe it is, what eases or worsens it and what has been tried. Record the negatives that matter, such as no fever with a new cough, not a habitual full review of systems.

Under the American Medical Association's coding guidelines, the care team may collect history, and patients may supply it by portal or questionnaire2, as long as you review it. An intake form can gather much of it before the visit. Whoever collects it, confirm medications and allergies every time.

In a hospital progress note, the subjective part opens with overnight events, and the daily notes later feed the discharge summary.

Record only what you examined

Give vital signs, the findings for systems you actually examined, and results with values and dates. Put a trend beside the number: "A1c 8.1%, up from 7.4% in March" says more than either value alone.

Templates and copying are where this part goes wrong. A 2014 report by the HHS Office of Inspector General warned that some record systems generate extensive documentation from a single click of a checkbox3. Unedited, that text may be inaccurate, the report said, and so may copied text that isn't updated.

In a 2022 JAMA Network Open study of 104 million notes written at Penn Medicine from 2015 to 2020, 50.1% of the text had been duplicated from earlier documentation4. If you carry text forward, reread every line and update what has changed.

Never chart an exam you didn't do

If you didn't listen to the lungs, "lungs clear" from a template is a false entry. Leave the system out, or record exactly what you checked.

Write the assessment and plan by problem

Number each problem you addressed, starting with the reason for the visit. Under the AMA's coding guidelines, a problem counts as addressed when you evaluate or treat it at the encounter2. "Followed by cardiology," with no assessment or care coordination from you, doesn't count.

For each problem, give your impression, its status and the findings behind it. Judge status against the patient's goal: the AMA's definitions say a patient who is not at their treatment goal is not stable2, even if nothing has changed. When the diagnosis is uncertain, name the possibilities you're weighing and what will tell them apart.

Write the plan under the problem it serves. Give each medication change as drug, dose, route, frequency and reason, and each referral the question you want answered. End with when the patient should return. A referral letter carries that question to the specialist, and a patient education handout puts your advice in plain words.

Spell out anything that could be misread. The Institute for Safe Medication Practices lists abbreviations and dose notations misinterpreted in harmful or potentially harmful medication errors5. Write "daily," not "QD"; "units," not "U"; and the full drug name, not "MS." Write 1 mg, not 1.0 mg, and 0.5 mg, not .5 mg, since a missed decimal point turns them into 10 mg and 5 mg.

The assessment and plan support the billing level. For most visit types, CMS says, the level now rests on medical decision making or time1, not on how much history and exam you record. The AMA's guidelines rate decision making on three elements: the problems addressed, the data reviewed or ordered, and the risk of the tests and treatments chosen or considered. If you bill by time, CMS asks for the total time or the start and stop times.

ExampleOne visit, from shorthand to SOAP noteAn illustrative example written for this guide

Shorthand: 58M f/u HTN and T2DM. Home BPs 140s-150s. No CP or SOB. BP 152/94, HR 78. A1c 8.1 (was 7.4 in March). Feet: monofilament intact. Plan: lisinopril 10 to 20 mg daily, BMP in 2 wks, RTC 3 mo.

Subjective: 58-year-old man for follow-up of hypertension and type 2 diabetes. Home blood pressures in the 140s to 150s. No chest pain or shortness of breath. Medications: lisinopril 10 mg daily; others [not recorded]. Allergies: [not recorded].

Objective: BP 152/94, heart rate 78. Hemoglobin A1c 8.1%, up from 7.4% in March. Feet: monofilament sensation intact.

Assessment and plan: 1. Hypertension, above goal on lisinopril 10 mg daily. Increase lisinopril to 20 mg by mouth daily. Basic metabolic panel in 2 weeks.

2. Type 2 diabetes, A1c rising. Plan: [not stated; confirm before signing].

Follow-up: return in 3 months.

  • Reported, not found. "No chest pain" is what the patient said, so it sits under subjective.
  • Status against the goal. "Above goal" tells the next reader why the dose went up.
  • Every problem gets a plan. The shorthand never says what was decided about the rising A1c, so the note asks.

Finish and sign it the same day

Finish the note while the visit is fresh. CMS asks clinicians to document services during the encounter or as soon as possible afterward1 to keep the record accurate. Record work often spills into the evening. In a 2016 study of 57 US physicians, the 21 who kept diaries reported 1 to 2 hours of after-hours work each night, mostly on the electronic record6.

If you remember something after signing, add a dated addendum instead of rewriting the note. Medicare's Program Integrity Manual says the date and author of any amendment, correction or delayed entry should be identifiable7, with the change clearly and permanently marked.

Check your own rules

Your organization and payers set what a note must contain; ask your coders or compliance team about levels. This is general information, not clinical, coding or legal advice.

Before you sign

  • Medications and allergies confirmed at this visit
  • Every exam finding is one you actually checked
  • Each problem has a status and its own plan
  • Medication changes give drug, dose, route, frequency and reason
  • No error-prone abbreviations, trailing zeros or missing leading zeros
  • Copied text reread, and still true

To start from notes you already have, paste them into the tool at the top of this page. It sorts them into the four parts, adds no clinical details you didn't write, and lists any gaps above the note.

How it works

Paste your visit shorthand, a dictation or a transcript, and pick the kind of visit if you like. River sorts every statement into the four SOAP parts and writes the note in your workspace, with an assessment and plan for each problem. It never adds a finding, a vital sign or a dose you didn't document, and it leaves an ambiguous abbreviation, such as "MS," as written and flags it.

Above the note, a list names what to confirm before you sign. It covers missing allergies or medications, no exam for the main complaint, a medication change with no dose, red-flag symptoms with no plan, and likely interactions. Check it, then paste the note into your record, or ask River for patient instructions or a shorter version.

  1. Paste your notes

    Shorthand, a dictation or a visit transcript, plus the kind of visit and how you like your notes.

  2. River sorts it

    Every statement goes under subjective, objective, assessment or plan, written out, with nothing added that isn't in your notes.

  3. Get your SOAP note

    A note in your workspace with an assessment and plan per problem, and the gaps to confirm listed above it.

  4. Check and sign

    Settle each flag, ask for patient instructions or a shorter version, then paste it into your record.

What you get

  • Subjective, objective, assessment and plan sorted from your shorthand, with abbreviations expanded only when unambiguous
  • An assessment and plan for each problem, with drug, dose, route, frequency and what changed
  • Only the findings, vital signs and results you documented, with no normal exam or default negatives
  • A list above the note of what to confirm, such as missing allergies or an undescribed exam
  • Flags for red-flag symptoms without a plan, likely interactions or dose concerns, left for you to decide
  • A closing line naming the decision-making elements the note documents, without choosing a billing level

Common questions

What is a SOAP note?

A SOAP note is a structured record of one patient encounter, named for its four sections: Subjective, Objective, Assessment and Plan. Physicians, nurse practitioners, physician assistants, nurses and therapists all use it. Because the order is always the same, anyone who opens the chart knows where to find the history, the findings and the decisions.

What is the difference between subjective and objective in a SOAP note?

Subjective is what the patient or family reports: symptoms, history, medications and how they feel. Objective is what you observe or measure: vital signs, exam findings and test results. A useful test is the source. If the patient told you, it goes under subjective, even a negative such as no chest pain. If you saw, heard, felt or measured it, it goes under objective.

How long should a SOAP note be?

As long as the visit needs and no longer. There is no required length, and for most US visits the length of the history and exam doesn't affect the billing level, which rests on decision making or time. A focused follow-up may fit in a short paragraph per section. Put your effort into the assessment and plan, where your reasoning shows.

Will River fill in a normal exam or review of systems?

No. River writes only the exam findings and symptoms in your notes, and never adds normal findings or stock negatives such as "denies." If you didn't describe an exam for the main complaint, the list above the note asks about it rather than filling one in. You stay the author of every finding in the record.

Can I paste identifiable patient details?

Only as your organization's policy allows. If your practice has a business associate agreement with River, work within its terms. Without one, leave out what HIPAA's Safe Harbor method treats as identifiers, such as names, street addresses, record numbers, dates more specific than the year and exact ages over 89. Age, sex and the clinical facts are enough, and you add identifiers in your own record.

How do I write a SOAP note with River?

Paste your visit shorthand, a dictation or a transcript into the box at the top of this page, and choose the kind of visit if you like. River writes the SOAP note into your free River workspace, with a list of gaps and safety flags above it. Check the list, edit anything, then paste the note into your record system and sign it there.

Is the SOAP note generator free?

Yes, it is free to start. Your SOAP note opens in a River workspace, where you can edit it, share it or ask River to change it. Paid plans add more AI use and access to the most advanced models.

Sources

  1. CMS. “Evaluation and Management Services.” cms.gov (opens in a new tab)

  2. American Medical Association. “CPT® Evaluation and Management (E/M) Code and Guideline Changes.” ama-assn.org (opens in a new tab)

  3. HHS Office of Inspector General. “CMS and Its Contractors Have Adopted Few Program Integrity Practices To Address Vulnerabilities in EHRs.” oig.hhs.gov (opens in a new tab)

  4. JAMA Network Open. “Prevalence and Sources of Duplicate Information in the Electronic Medical Record.” jamanetwork.com (opens in a new tab)

  5. Institute for Safe Medication Practices. “ISMP List of Error-Prone Abbreviations, Symbols, and Dose Designations.” online.ecri.org (opens in a new tab)

  6. Annals of Internal Medicine. “Allocation of Physician Time in Ambulatory Practice: A Time and Motion Study in 4 Specialties.” pubmed.ncbi.nlm.nih.gov (opens in a new tab)

  7. CMS. “Medicare Program Integrity Manual, Chapter 3 – Verifying Potential Errors and Taking Corrective Actions.” cms.gov (opens in a new tab)

Built by

Chandler Supple

Co-founder & CEO, River

Chandler has spent the last six years working in AI, building tools for millions of users and Fortune 100 companies. In 2025, he co-founded River to build a new kind of operating system for AI agents.

Reviewed by

Brian Joseff, Co-founder, River