An HPI template gives clinicians a ready-made structure for documenting the History of Present Illness, so the story of the patient's chief complaint (onset, quality, severity, timing, and everything in between) lands in the chart in a format any reader can follow.

Below you'll find a free, downloadable HPI template, three completed worked examples, a comparison of the common HPI frameworks (OLDCARTS, OPQRST, and SOCRATES), and a step-by-step guide to writing an HPI that supports your assessment, your coding, and any future review of the chart.

Quick download: Grab the free HPI template PDF here.

Key Takeaways

• Eight primary elements: Location, quality, severity, duration, timing, context, modifying factors, and associated signs and symptoms. You rarely need all eight, but a template stops you from discovering a missing one after the patient has left.
  
  

• Pertinent negatives are documentation: "Denies chest pain, dyspnea, or syncope" in a palpitations HPI shows your clinical reasoning and protects the note in review. A template with a dedicated pertinent-negatives prompt makes this automatic.
  
  

• A template solves structure and an AI scribe saves time: Most HPIs are typed after the visit, when recall is weakest. An AI medical scribe can draft the HPI in your template's exact format while you keep eye contact with the patient.

What Is an HPI Template?

An HPI template is a structured format for documenting the History of Present Illness, the chronological account of a patient's current complaint, from first symptom to the moment they sit down in front of you. It captures where the problem is, what it feels like, how bad it is, when it started, what makes it better or worse, and what else has come with it.

Think of the HPI as the narrative core of the medical note. The chief complaint tells you why the patient is here in their own words; the HPI tells the story behind it in yours. Everything downstream (the exam you perform, the differential you build, the workup you order) traces back to it.

The 8 Elements of an HPI

CMS's historical E/M documentation guidelines defined eight elements, and they remain the shared vocabulary clinicians, coders, and auditors all use. Our free template is organized around them:

• Location: Where the symptom is and whether it radiates. "Substernal chest pressure radiating to the left arm" does diagnostic work that "chest pain" doesn't.
  
  

• Quality: The character of the symptom, ideally in the patient's own words: sharp, dull, burning, crushing, throbbing, colicky.
  
  

• Severity: A 0-10 pain score, or a functional anchor, such as "can't climb one flight of stairs," "woke her from sleep."
  
  

• Duration: How long this episode has been going on, and how long each occurrence lasts.
  
  

• Timing: The pattern, e.g. constant, intermittent, worse in the morning, only after meals.
  
  

• Context: What the patient was doing when it started, and any relevant circumstances: trauma, travel, new medication, sick contacts.
  
  

• Modifying factors: What makes it better or worse, including anything the patient has already tried and how it worked.
  
  

• Associated signs and symptoms: What travels with the main complaint and, just as importantly, the pertinent negatives that don't.

Since the 2021 E/M changes, outpatient visit levels are selected on medical decision-making or time, not on counting HPI elements. That freed the HPI to do its real job, telling a clinically useful story, rather than serving as a billing checklist. 

HPI Examples

The structure above reads differently depending on the setting. Here are three short, realistic examples. (All patient details are fictitious.)

HPI Example: Acute Chest Pain (Emergency / Urgent Care)

HPI: 58-year-old male with a history of hypertension and hyperlipidemia presents with substernal chest pressure that began 45 minutes ago while mowing the lawn. He describes it as "an elephant sitting on my chest," 8/10, radiating to the left arm and jaw. It is constant, unrelieved by rest, and associated with diaphoresis and nausea. He took two chewable aspirin at home without improvement. He denies shortness of breath, syncope, palpitations, or prior similar episodes. No recent travel, surgery, or leg swelling.

Notice how every element is present without a single labeled heading. The story carries the structure, and the final two sentences are pure pertinent negatives that shape the differential.

HPI Example: Chronic Abdominal Pain (Primary Care)

HPI: 34-year-old female presents with intermittent epigastric burning for approximately 3 months. Episodes occur 3-4 times per week, typically 30-60 minutes after meals, lasting up to two hours. Severity is 4-5/10. Symptoms are worse with coffee, spicy food, and lying flat after dinner, and partially relieved by over-the-counter antacids. She reports occasional sour taste in the mouth and nighttime cough. She denies dysphagia, odynophagia, vomiting, melena, unintentional weight loss, or early satiety. No NSAID use. Symptoms are increasingly affecting sleep, prompting today's visit.

HPI Example: Follow-Up Visit (Chronic Condition)

HPI: 67-year-old male with type 2 diabetes returns for a 3-month follow-up. Since the last visit, home fasting glucose readings have ranged 110-140 mg/dL, improved from 160-190 after the metformin dose increase. He reports good adherence with no GI side effects. He walks 30 minutes daily, 5 days per week. He denies polyuria, polydipsia, blurred vision, numbness or tingling in the feet, and hypoglycemic episodes. Interval history is otherwise negative.

Follow-up HPIs trade the eight symptom elements for interval change: status of the condition, response to treatment, adherence, and new or resolved symptoms since the last encounter. A flexible HPI template covers both.

How to Write a Strong HPI: Step by Step

A template gives you the skeleton. These five habits turn it into an HPI that actually supports your assessment.

1. Open with a one-line frame

Age, relevant history, and the chief complaint with duration: "58-year-old male with HTN presents with 45 minutes of substernal chest pressure." That single sentence orients every subsequent reader (the consultant, the covering physician, the coder) before they've read anything else.

2. Tell it in chronological order

Start when the symptom started, not when the patient arrived. A history that jumps between timepoints forces the reader to reconstruct the sequence themselves, and sequence is often the diagnosis: pain then vomiting reads very differently from vomiting then pain.

3. Use the patient's words for quality, your words for everything else

"An elephant sitting on my chest" in quotes is worth more than "pressure-like discomfort," because it's verifiable and vivid. But keep the surrounding narrative in precise clinical language, quantified severity, specific timing, named modifying factors.

4. Document the pertinent negatives

The negatives are where your clinical reasoning becomes visible. Denying dyspnea, syncope, and palpitations in a chest pain HPI shows you considered PE and arrhythmia. Aim for the three to six negatives that genuinely narrow this differential, not a boilerplate list pasted into every note.

5. Close with impact and what's been tried

How the symptom affects work, sleep, or function and what the patient has already done about it. "Antacids partially effective, symptoms now disrupting sleep" is a bridge straight into your assessment.

Bottom line: A strong HPI is a short story with a timeline, not a form with blanks. The template's job is to make sure no chapter goes missing.

Common HPI Mistakes to Avoid

Even experienced clinicians fall into the same traps, especially when notes are written hours after the visit.

• Restating the chief complaint and stopping. "Patient here for back pain" is a chief complaint, not a history. Fix it by walking through onset, quality, severity, and course.
  
  

• Copy-forward drift. Pulling last visit's HPI forward and lightly editing it produces notes where the story no longer matches today's visit, which is a genuine liability in review. Write the interval history fresh.
  
  

• Vague quantifiers. "Pain for a while," "feels bad," "sometimes worse." Replace with numbers and anchors: "3 weeks," "7/10," "worse within 30 minutes of meals."
  
  

• Missing pertinent negatives. A syncope HPI without a cardiac review of the event reads as an incomplete workup, whatever you actually asked in the room.
  
  

• Burying the timeline. Findings listed in the order the patient mentioned them rather than the order they happened. Reorganize chronologically before you sign.

HPI Formats Compared: OLDCARTS vs OPQRST vs SOCRATES

All three common ones cover the same ground; they differ in emphasis and where they're taught.

There's no universally "correct" choice. Pick the mnemonic your team already thinks in, then build your template around it so every note is predictable.

Hands-Free HPI Documentation with Sully.ai

A template solves the structure problem. It doesn't solve the timing problem: the HPI is the most narrative part of the note, which makes it the slowest to type and the most likely to be reconstructed from memory at the end of the day.

This is where an AI medical scribe changes the workflow. With Sully.ai, you start the scribe at the beginning of the encounter and let ambient AI capture the conversation. By the time the patient leaves, a structured HPI, organized around your template, in chronological order, with pertinent negatives included, is drafted and ready for your review.

The downstream benefits compound across a clinic day:

• More face time, less screen time. The history gets taken by talking to the patient, not by typing while half-listening.
  
  

• More complete notes. Details like exact durations, medication trials, and negatives are captured live through real-time transcription rather than reconstructed hours later.
  
  

• Cleaner downstream coding. A specific, well-structured HPI gives your coding and billing workflow the documentation it needs to support medical decision-making.

Sully.ai is built for healthcare from the ground up and meets HIPAA standards for handling protected health information, one part of a broader team of AI employees designed to take documentation off clinicians' plates.

Frequently Asked Questions

What are the 8 elements of an HPI?

The eight elements are location, quality, severity, duration, timing, context, modifying factors, and associated signs and symptoms. They come from CMS's E/M documentation guidelines and remain the standard framework for a complete History of Present Illness, even though outpatient coding no longer requires counting them.

What is the difference between HPI and ROS?

The HPI is a deep, chronological dive into the patient's current complaint. The review of systems (ROS) is a broad screening sweep across body systems to surface symptoms the patient didn't volunteer. A symptom explored in detail belongs in the HPI; a checklist of screening questions belongs in the ROS and double-documenting the same finding in both is a common audit flag.

Who can document the HPI?

Under CMS rules, the billing provider must personally perform and document (or review, update, and verify) the HPI. Ancillary staff can record the chief complaint and ROS, and a scribe, human or AI, can draft the HPI from the provider's own encounter, but the provider remains responsible for its accuracy and must attest to it.

How long should an HPI be?

Usually four to eight sentences. A focused visit for a simple complaint might need three; a complex, multi-symptom presentation might run a full paragraph or two. A tight HPI that covers onset, course, modifying factors, and pertinent negatives outperforms a page of unstructured narrative.

Is OLDCARTS or OPQRST better for an HPI?

Neither is objectively better. OPQRST is optimized for acute pain and dominates in emergency and prehospital settings; OLDCARTS covers a broader range of complaints and maps directly onto the eight CMS elements, making it the safer default for clinic notes. Choose the one your team already uses and standardize your template around it.

Does the HPI still matter for billing after the 2021 E/M changes?

Yes, just differently. You no longer count HPI elements to justify a visit level, but the HPI substantiates the problems addressed and the complexity of your medical decision-making, which is exactly what current E/M levels are built on. A vague HPI undercuts the MDM story; a specific one supports it.

Can I create my own HPI template?

Absolutely. Start from a proven framework like the template here, then adjust the prompts to match your specialty, your organization's note format, and your preferred mnemonic. Once your structure is dialed in, an AI scribe can generate every HPI in that exact format automatically.

This template is provided for documentation reference only. Adapt it to your specialty, your organization's documentation policies, and current E/M guidelines. It does not replace clinical judgment.