HPI in Medicine: Meaning, OLDCARTS Template & 5 Examples
What HPI means in medical notes (History of Present Illness), the OLDCARTS framework clinicians use to structure it, and 5 example HPIs taken from real SOAP and H&P notes.

Table of Contents
What is HPI in Medical Terms?
HPI stands for History of Present Illness. It is a critical component of the medical history that provides a chronological description of the patient's current symptoms or chief complaint from onset to the present encounter.
The HPI tells the "story" of the patient's illness from their perspective. It documents how symptoms developed, what makes them better or worse, and any associated symptoms. This narrative helps clinicians understand the progression of the illness and guides diagnosis and treatment decisions.
Definition
"The History of Present Illness (HPI) is a chronological description of the development of the patient's present illness from the first sign and/or symptom to the present."
— CMS Documentation Guidelines
Where Does HPI Fit in Medical Documentation?
In SOAP notes and traditional medical documentation, the HPI is part of the "Subjective" section because it contains information provided by the patient (or their representative), not objective clinical findings.
S - Subjective
Chief Complaint, HPI, ROS, PFSH
O - Objective
Physical Exam, Vitals, Labs
A - Assessment
Diagnosis, Clinical Impression
P - Plan
Treatment, Follow-up
The 8 Elements of HPI
According to CMS documentation guidelines, there are 8 recognized elements of the History of Present Illness. Including more elements creates a more complete picture of the patient's condition.
Location
Where on the body the symptom or problem occurs
Examples: "Lower back pain," "right knee swelling," "substernal chest pain"
Quality
Characteristics of the symptom - how it looks or feels
Examples: "Sharp pain," "dull ache," "throbbing," "burning sensation"
Severity
How bad the symptom is, often on a 1-10 scale
Examples: "6 out of 10 pain," "unbearable," "mild discomfort"
Duration
How long the symptom has been present
Examples: "Started 3 days ago," "present for 2 weeks," "chronic for 6 months"
Timing
When symptoms occur and their pattern
Examples: "Constant," "intermittent," "worse at night," "occurs after meals"
Context
Circumstances or activities surrounding symptom onset
Examples: "Started while exercising," "after lifting heavy box," "during stress"
Modifying Factors
What makes the symptom better or worse
Examples: "Improves with rest," "worsens with movement," "OTC meds not helping"
Associated Signs/Symptoms
Other symptoms occurring with the chief complaint
Examples: "Nausea and sweating with chest pain," "fever with cough"
OLDCARTS Mnemonic for HPI Documentation
OLDCARTS is a popular mnemonic used by medical students, nurses, and physicians to remember the key elements to include when documenting the History of Present Illness. It ensures comprehensive symptom documentation.
When did the symptoms start? Was it sudden or gradual?
Where are the symptoms located? Does it radiate?
How long have the symptoms been present?
What is the nature/quality of the symptom?
What makes the symptoms worse?
What alleviates the symptoms?
Are symptoms constant or intermittent?
How severe are the symptoms on a 1-10 scale?
Alternative Mnemonics
- SOCRATES - Site, Onset, Character, Radiation, Associations, Time course, Exacerbating factors, Severity
- PQRST - Provocation/Palliation, Quality, Region/Radiation, Severity, Timing
- OPQRST - Onset, Provocation, Quality, Region/Radiation, Severity, Time
OLDCARTS Framework: Definitions & Example Phrases
Below is the OLDCARTS framework broken down letter by letter, with a clinical definition and a sample phrase a clinician would actually write in a SOAP or H&P note. Use these as a checklist when drafting an HPI from scratch — or when reviewing an AI-generated SOAP note for completeness.
Onset
When did the symptom start, and was it sudden or gradual? Onset often points to the underlying mechanism — sudden onset suggests vascular or traumatic causes, gradual onset suggests inflammatory or degenerative.
Example phrase: "Pain started suddenly 2 hours ago while shoveling snow."
Location
Where on the body the patient feels the symptom, and where (if anywhere) it radiates. Anatomic precision narrows the differential immediately.
Example phrase: "Substernal chest pain radiating to the left arm and jaw."
Duration
Total length of time the symptom has been present and how each episode lasts. Replace vague phrases like "a while" with concrete time units.
Example phrase: "Cough for 10 days, episodes lasting 2–3 minutes."
Characteristics
The quality of the symptom — sharp, dull, burning, throbbing, crampy. Quote the patient when possible because their description often points to a diagnosis.
Example phrase: "Patient describes the pain as ‘a pressure, like an elephant sitting on my chest.’"
Aggravating Factors
What makes the symptom worse — movement, food, stress, exertion, position. These are diagnostic clues and they shape the plan.
Example phrase: "Pain is worse with deep inspiration and lying flat."
Relieving Factors
What makes the symptom better — rest, OTC medications, position change, heat or ice. Document what the patient has already tried and how well it worked.
Example phrase: "Mild relief with ibuprofen 400 mg; no relief from rest or heating pad."
Timing
The pattern: constant vs. intermittent, time of day, relationship to activity, frequency. Timing distinguishes mechanical, inflammatory, and post-prandial conditions.
Example phrase: "Pain wakes him at 4 a.m., improves an hour after rising."
Severity
Intensity on a 0–10 scale, plus a functional impact statement (does it interrupt sleep, work, eating?). Severity at rest vs. with activity is often more useful than a single number.
Example phrase: "7/10 at rest, 9/10 with movement; unable to climb stairs."
Chief Complaint vs HPI: What's the Difference?
Chief Complaint (CC)
- Brief statement of why the patient is seeking care
- Usually stated in the patient's own words
- Short and concise (1-2 words or brief phrase)
- Examples: "chest pain," "cough," "fatigue"
History of Present Illness (HPI)
- Detailed expansion of the chief complaint
- Chronological narrative of symptom development
- Includes multiple elements (location, severity, duration, etc.)
- Comprehensive paragraph or detailed bullets
Example Comparison
HPI vs CC vs ROS: What's the Difference?
Three closely related elements live in the Subjective section of every clinical note, and they are easy to confuse. Here is the practical distinction clinicians use day to day:
| Element | What It Captures | Length | Example |
|---|---|---|---|
| CC (Chief Complaint) | The single reason for the visit, ideally in the patient's own words. | 1 line | "Chest pain for 2 hours." |
| HPI (History of Present Illness) | The chronological story of that complaint — onset, character, severity, what helps, what makes it worse. | 3–6 sentences | Substernal pressure radiating to the left arm, 8/10, started 90 minutes ago at rest, with diaphoresis… |
| ROS (Review of Systems) | A head-to-toe checklist of symptoms by body system, capturing positives and pertinent negatives outside the HPI. | 10+ systems | Constitutional: denies fever. CV: chest pain (see HPI). Resp: denies cough… |
Quick rule of thumb
CC is the headline. HPI is the article. ROS is the index of every other system you screened. For a deeper look at the systems checklist, see our review of systems guide.
HPI Examples by Specialty
Primary Care: Hypertension Follow-up
CC: Follow-up for high blood pressure
HPI: 58-year-old male with history of hypertension presents for routine follow-up. Patient reports good medication compliance with lisinopril 10mg daily. He denies headaches, visual changes, chest pain, or shortness of breath. Home blood pressure readings have been averaging 135/85mmHg over the past month. Patient notes mild ankle swelling in the evenings that resolves overnight. He has been maintaining a low-sodium diet but admits limited exercise due to knee arthritis. No symptoms of dizziness or orthostatic hypotension.
Emergency Medicine: Chest Pain
CC: Chest pain
HPI:62-year-old male with history of hyperlipidemia and smoking presents with substernal chest pain (location) that started 1 hour ago (onset) while mowing the lawn (context). The pain is described as "pressure-like" (quality), rated 8/10 (severity), constant since onset (timing), radiating to the left arm. Associated symptoms include diaphoresis and nausea. Pain is not relieved by rest or antacids. Patient took aspirin 325mg prior to arrival. He denies shortness of breath, palpitations, or recent illness. Last meal was 4 hours ago.
Psychiatry: Depression Follow-up
CC: Follow-up for depression
HPI:34-year-old female presents for 6-week follow-up since starting sertraline 50mg. Patient reports gradual improvement in mood over the past 3 weeks. She notes better sleep quality, sleeping 7 hours nightly compared to 4-5 hours previously. Energy levels are "somewhat better" but still not at baseline. Patient reports decreased frequency of crying spells (from daily to 1-2 times weekly). Appetite has normalized. She denies suicidal ideation, self-harm thoughts, or auditory/visual hallucinations. Side effects include mild nausea for the first week that has since resolved. Patient has been attending weekly therapy sessions.
Orthopedics: Knee Pain
CC: Right knee pain
HPI:52-year-old male presents with right knee pain (location) that has been progressively worsening over the past 6 months (duration). The pain is described as a deep ache (quality), rated 5/10 at rest and 8/10 with activity (severity). Pain is worse in the morning with stiffness lasting about 30 minutes (timing). Climbing stairs and prolonged walking aggravate symptoms (aggravating factors), while rest and ice provide some relief (modifying factors). Patient notes occasional "grinding" sensation and intermittent swelling (associated symptoms). No history of trauma. He has tried OTC NSAIDs with moderate benefit. Patient is a former marathon runner.
5 Real HPI Examples (Different Settings)
Five short, scenario-based HPIs you can model your own documentation on. Each one is OLDCARTS-complete and the kind of paragraph you would copy into the Subjective section of a SOAP note or the front of an H&P template.
Chest Pain in the Emergency Department
58 y/o male with HTN and 30-pack-year smoking history presents with substernal chest pressure that began 90 minutes ago while watching TV. Pain is "like a heavy weight," 8/10 at rest, radiating to the left jaw and arm, associated with diaphoresis and one episode of nausea. Pain unrelieved by 3 sublingual nitroglycerin tablets given by EMS. Denies recent trauma, fever, cough, or syncope. No prior similar episodes.
Headache in Primary Care
34 y/o female presents with a 3-week history of intermittent right-sided throbbing headaches, occurring 2–3 times per week, lasting 4–6 hours. Pain is 6/10, worsens with bright lights and physical activity, and is preceded by a 20-minute visual aura. Partial relief with ibuprofen 600 mg if taken at onset. Associated with nausea but no vomiting. Denies fever, neck stiffness, weakness, or recent head trauma. Pattern began after starting a new job.
Abdominal Pain in Urgent Care
27 y/o female presents with right lower quadrant abdominal pain that began as periumbilical discomfort yesterday afternoon and migrated to the RLQ overnight. Pain is constant, sharp, 7/10, worse with movement and coughing. Reports nausea, two episodes of non-bloody emesis, and anorexia. Denies diarrhea, dysuria, or vaginal bleeding. LMP 2 weeks ago, regular cycles. No fever measured at home but feels warm.
Depression Follow-Up in Psychiatry
41 y/o male returns for 8-week follow-up on sertraline 100 mg daily for major depressive disorder. Reports gradual mood improvement over the last 4 weeks: PHQ-9 today is 7, down from 18 at baseline. Sleep has normalized to 7 hours, energy improved, and he resumed exercising twice weekly. Denies SI, HI, hopelessness, or psychotic symptoms. Notes mild GI upset in week 1, now resolved. Continues weekly CBT with no missed sessions.
Post-Op Knee Follow-Up in Orthopedics
62 y/o male, 6 weeks status post right total knee arthroplasty, presents for routine follow-up. Reports pain is 3/10 at rest, 5/10 with PT, down from 8/10 at week 2. Ambulating with a single cane, walking ~30 minutes daily. Denies fevers, chills, calf pain, redness, or wound drainage. Sleep is intermittently disturbed by knee stiffness. Completed 12 of 18 PT sessions; ROM per PT note 0–115°. No new falls or trauma.
All examples are illustrative and de-identified. Length is intentionally short — most clinically useful HPIs land between 80 and 150 words.
HPI Documentation Requirements
Brief HPI
Requires 1-3 HPI elements
- • Appropriate for straightforward visits
- • Supports lower E/M levels (99212-99213)
- • Common for simple acute complaints
Extended HPI
Requires 4 or more HPI elements
- • Supports higher E/M levels (99214-99215)
- • Required for comprehensive histories
- • Standard for complex visits
Important Documentation Notes
- • Under older CMS guidelines, only the billing physician could document the HPI
- • Since 2021 E/M changes, ancillary staff documentation is now acceptable for office visits
- • The HPI should always be based on patient interviews, not assumptions
- • Document pertinent negatives (what the patient denies)
- • Be specific with timing - "a few days" should be "3 days"
HPI and E&M Coding for 2026
The role of HPI in E&M coding has evolved significantly. Under the 2021 CMS changes (extended to other E&M services in 2023), medical decision-making (MDM) or total time are now the primary determinants for selecting E/M levels for most services.
Key 2026 E/M Considerations
Office/Outpatient Visits (99202-99215)
HPI documentation is still required but doesn't directly determine code level. Focus on MDM or time.
Hospital and ED Services
Similar MDM-based selection now applies. HPI supports clinical reasoning but isn't counted for level selection.
Medical Necessity
A thorough HPI still supports medical necessity and clinical decision-making documentation.
The "4-2-1" Rule (Historical Reference)
For services still using 1995/1997 guidelines, the "4-2-1" rule ensured a comprehensive history:
- • 4 HPI elements (extended HPI)
- • 2 areas of PFSH (past/family/social history)
- • 1 item per system for ROS (at least 10 systems)
Best Practices for HPI Documentation
Be Specific with Timing
Instead of "a while ago," document "3 weeks ago" or "since Monday."
Use Patient's Words
Quote the patient when describing quality: "feels like an elephant on my chest."
Document Pertinent Negatives
"Denies fever, nausea, or vomiting" helps narrow the differential diagnosis.
Follow Logical Order
Start with onset, then describe progression chronologically to the present.
Quantify When Possible
Use scales (1-10 for pain), frequencies, and measurable units.
Include Prior Treatments
Document what the patient has already tried and the results of those treatments.
Connect to Chief Complaint
Every HPI element should relate back to why the patient is seeking care.
Avoid Copy-Forward Errors
Ensure each HPI reflects the current visit, not outdated information from previous encounters.
Automate Your HPI Documentation with AI
PatientNotes AI scribe listens to your patient conversations and automatically generates comprehensive HPI documentation with all relevant elements. Save time while ensuring thorough, compliant documentation.
Start Free TrialFrequently Asked Questions
What does HPI stand for in medical documentation?
HPI is the medical abbreviation for History of Present Illness. It is the chronological narrative of the patient's current symptom — when it started, how it has changed, and what makes it better or worse. The HPI lives in the Subjective section of a SOAP note and at the start of the H&P.
What is the OLDCARTS framework?
OLDCARTS is a memory aid for the eight things to capture in an HPI: Onset, Location, Duration, Characteristics, Aggravating factors, Relieving factors, Timing, and Severity. Walking through each letter ensures you do not skip a clinically important detail. Most clinicians weave the answers into a single short paragraph rather than listing them.
How long should an HPI be?
A focused acute HPI is usually 3–6 sentences (about 80–150 words). A complex new patient or hospital admission HPI may run 200–400 words. Length should follow medical necessity, not E/M level — modern 2021/2023 guidelines select level by MDM or time, not history element counts.
What's the difference between CC and HPI?
The Chief Complaint (CC) is a one-line statement, ideally in the patient's own words, of why they came in — for example, "chest pain x 2 hours." The HPI is the detailed chronological story behind that CC: onset, character, severity, what helps, and associated symptoms. CC tells you what; HPI tells you why and how.
Is HPI part of SOAP notes?
Yes. The HPI sits inside the Subjective (S) section of a SOAP note, alongside the Chief Complaint, Review of Systems, and pertinent Past/Family/Social history. The Objective, Assessment, and Plan sections come after.
How many elements does Medicare require in an HPI?
Under the legacy 1995/1997 CMS guidelines, a Brief HPI required 1–3 elements and an Extended HPI required 4 or more. Since 2021 for office visits, and 2023 for hospital and ED services, level selection is based on MDM or total time, so element counting is no longer required for billing — though a thorough HPI still supports medical necessity.
Can an AI scribe write the HPI for me?
Yes. Modern ambient AI scribes like PatientNotes listen to the visit and draft a complete HPI with onset, location, severity, modifying factors, and pertinent negatives — typically in under a minute. The clinician reviews and edits before signing, which is faster than writing from scratch and tends to capture more OLDCARTS elements.
Related Resources
SOAP Notes Guide
Complete guide to SOAP note documentation structure and best practices.
History & Physical Template
Full H&P template with HPI, ROS, exam, assessment, and plan sections.
Review of Systems Guide
How the ROS complements the HPI — full system-by-system checklist.
Free SOAP Note Generator
Paste a transcript and get a structured SOAP note with HPI included.
HPI Templates
Ready-to-use HPI templates for various clinical scenarios.
PatientNotes AI Scribe
See how an ambient AI scribe drafts your HPI from the conversation.