A migraine SOAP note template is a structured documentation format designed specifically for recording headache disorders, particularly migraine, in clinical neurology practice.
Migraine evaluation is highly pattern-driven. It requires detailed symptom characterization, trigger identification, neurological examination, and longitudinal tracking. A structured template ensures no critical diagnostic element is missed while maintaining consistency across visits.
Migraine cases involve:
Generic SOAP note templates fail because they:
The following structure below reflects how migraine evaluations are typically documented in practice.
Fictional patient encounter for educational/reference use, not a real record.
Patient: Jane A. Doe | DOB: 04/12/1990 | Age: 36 | Sex: Female | MRN: 00234871Date of Visit: 08/31/2026 | Referring Provider: Dr. R. Simmons | Neurologist: Dr. L. Okafor | Accompanied By: Spouse
Chief Complaint: "My headaches are happening more often and are harder to control." Duration of symptoms: recurrent headaches for 8 years, worsening over the last 3 months.
History of Present Illness: Headaches began at age 28 during a period of high work stress, with gradual worsening over time. The course has shifted from episodic (4–5 days/month) to a more chronic pattern (10–12 headache days/month), 4 of which meet full migraine criteria with aura. Untreated attacks last 12–24 hours; with treatment, they typically resolve in 4–6 hours.
Pain Characteristics: Right-sided frontotemporal, occasionally bilateral during severe episodes. Throbbing/pulsatile quality. Peak intensity 7–8/10.
Associated Symptoms: Nausea in most attacks, vomiting in ~30% of severe episodes, marked photophobia and phonophobia, mild osmophobia, occasional non-rotational dizziness (no vertigo), mild ipsilateral neck tightness pre-headache, and "brain fog"/word-finding difficulty during attacks.
Aura History: Visual aura (zigzag lines, scintillating scotoma) lasting 15–20 minutes in ~40% of attacks; occasional unilateral fingertip tingling spreading proximally. No speech disturbance or motor symptoms (relevant negative for hemiplegic migraine).
Triggers: Stress (especially deadlines), sleep deprivation (<6 hrs), perimenstrual hormonal changes, bright/flickering light, strong odors, red wine, aged cheese, and skipped meals.
Aggravating / Alleviating Factors: Aggravated by physical activity, bright light, noise, and bending forward. Alleviated by rest, sleep, sumatriptan (partial relief), and cold compress.
Functional Impact: Missed 3 workdays and reduced productivity on 5 more in the past month; unable to complete household tasks during attacks; has repeatedly canceled social plans, straining family activities.
Medication Use History: Acute,sumatriptan 50 mg PRN (~10 days/month), ibuprofen 400 mg PRN. Preventive, propranolol trialed 6 months ago, discontinued for fatigue; not currently on prophylaxis. Response to triptans is partial; no CGRP trial to date.
Medication Overuse Assessment: Triptan use ≥10 days/month for 3 consecutive months, meets ICHD-3 threshold for overuse; high risk for medication-overuse headache (MOH). Patient counseled.
Past Medical / Surgical History: No neurological conditions besides migraine. Generalized anxiety disorder, stable on treatment. No vascular risk factors (non-smoker, no HTN, no stroke/TIA history). Mild seasonal allergic rhinitis. Surgical history limited to tonsillectomy at age 10.
Current Medications: Sertraline 50 mg daily, sumatriptan 50 mg PRN, ibuprofen 400 mg PRN, loratadine seasonally, magnesium glycinate 400 mg daily, riboflavin (B2) 400 mg daily. Good adherence; no significant side effects.
Allergies: NKDA. Seasonal pollen allergy, no anaphylaxis history.
Family History: Mother with migraine with aura; maternal aunt with chronic migraine. No family history of epilepsy, stroke, or MS.
Social / Lifestyle History: Marketing manager, sedentary desk job with high screen time; exercises 1–2x/week; occasional alcohol (1–2 drinks/week); no tobacco or recreational drug use; moderate caffeine (2 cups coffee/day). Sleep is inconsistent (5.5–6.5 hrs/night, difficulty falling asleep); self-rated stress 7/10; inadequate hydration; irregular meal timing, frequently skips breakfast.
Headache Disability Assessment: MIDAS score 24 (Grade IV, severe disability). HIT-6 score 66 (severe impact).
Review of Systems: Neurological, positive for headache/aura as above, denies seizures or persistent focal weakness/numbness. ENT, denies hearing loss, tinnitus, sinus pressure outside attacks. Psychiatric, anxiety (managed), denies depression or SI/HI. GI, nausea/vomiting only with attacks. General, denies fever, weight loss, night sweats.
Red Flag Screening: No thunderclap headache, no late-onset presentation, no persistent neurological deficit, no signs of infection or malignancy. SNNOOP10 criteria reviewed, no red flags identified.
Headache Diary Data: 10–12 headache days/month over the past 3 months per patient-tracked diary; correlates with poor sleep (6/12 days) and perimenstrual timing (3/12 days). Triptan use logged on 10 of the last 30 days.
Vital Signs: BP 118/76 mmHg | HR 72 bpm | RR 16/min | Temp 98.4°F (36.9°C) | SpO2 99% on room air.
General Physical Exam: Well-nourished, no acute distress at time of visit (currently headache-free); normal, steady gait.
Head & Neck Exam: Mild scalp tenderness over the right temporal region. TMJ non-tender, no clicking. Mild cervical paraspinal tightness with full, non-tender range of motion.
Neurological Exam: Alert and oriented x4, normal speech and cognition. Cranial nerves II–XII grossly intact. Motor strength 5/5 throughout, no pronator drift. Sensation intact to light touch, pinprick, and proprioception. Reflexes 2+ and symmetric. Coordination intact (finger-to-nose, heel-to-shin). Normal tandem gait.
Fundoscopic Exam: No papilledema; optic discs sharp, normal color, no hemorrhages or exudates bilaterally.
Diagnostic Studies: Prior brain MRI (2 years ago) unremarkable; no new imaging indicated given absence of red flags. Lumbar puncture not performed, no indication. CBC, CMP, and TSH within normal limits (last checked 6 months ago).
Clinical Summary: Longstanding episodic migraine with aura, now trending toward chronic migraine (≥8 migraine days/month) with likely superimposed medication-overuse headache from frequent triptan use. No red flags on history or exam; significant functional disability per MIDAS/HIT-6.
Primary Diagnosis: Chronic migraine with aura, complicated by probable medication-overuse headache (ICHD-3 codes 1.3 and 8.2).
Headache Classification: Meets ICHD-3 criteria for Migraine with Aura (1.2) and Chronic Migraine (1.3), ≥15 headache days/month with ≥8 meeting migraine criteria for >3 months.
Differential Diagnosis: Tension-type headache less likely given pulsatile quality, aura, photophobia/phonophobia. Cluster headache unlikely, lacks autonomic features and characteristic short, clustered episodic pattern. Secondary causes have low pretest probability given normal exam, no red flags, and prior unremarkable MRI, but warrant continued monitoring.
Severity / Disability: MIDAS Grade IV (severe) and HIT-6 severe-impact category support escalation of therapy.
Acute Treatment: Continue sumatriptan but restrict to ≤2 days/week to reduce MOH risk; consider an alternate triptan or route (e.g., nasal) if response remains inadequate. Naproxen 500 mg at onset for mild-moderate attacks (limit 2–3 days/week). Metoclopramide 10 mg PRN for nausea/vomiting.
Preventive Treatment: Propranolol will not be re-trialed given prior intolerance. Discuss topiramate, weighing cognitive side-effect profile. Patient is a candidate for a CGRP monoclonal antibody given chronic migraine and prior preventive failure. Consider OnabotulinumtoxinA (PREEMPT protocol) if CGRP therapy is inadequate or contraindicated.
Non-Pharmacologic Management: Regularize sleep schedule, consistent meal timing, improved hydration, reduced caffeine. Referral for CBT and biofeedback to address stress-related triggers.
Diagnostic Plan: No acute imaging needed; repeat MRI only if red flags develop. Labs already current, no additional testing now. Referral to headache specialist for CGRP therapy initiation and to behavioral health for CBT.
Patient Education: Reviewed sleep hygiene, hydration, and dietary trigger avoidance (alcohol, aged cheese). Educated on medication-overuse headache risk and the importance of limiting acute medication days. Encouraged regular exercise, stress management, and continued headache diary logging.
Follow-Up: Return in 4–6 weeks to assess response to preventive therapy adjustments and MOH mitigation. Advised to seek emergent care for sudden "worst headache of life," new neurological deficits, fever with stiff neck, or headache following head trauma.
The template gives you the structure. When you start using it with Marvix AI, the documentation itself adapts to how you write.
Marvix AI uses neural style transfer to learn from your existing notes so you have custom-made templates for all your workflows. It picks up your tone, your phrasing, and structure, then carries that into every note it generates.
If your notes are concise and point-wise, the output stays that way. If you write in a more narrative flow, it follows that instead. The note reads like something you wrote, not something you cleaned up.
This carries across clinical notes, after visit summaries, referral letters, IME reports and every other kind of documentation. And when you need a template for a new document type, Marvix AI builds it from your existing notes rather than starting from scratch.
Generic templates provide structure but lack depth for migraine-specific documentation. AI scribes improve speed but often produce inconsistent outputs without specialty alignment. Marvix AI combines structured templates with learned physician-specific style, ensuring both completeness and personalization.
| Feature | Generic Templates | AI Scribes | Marvix AI |
|---|---|---|---|
| Migraine-specific structure | Limited | Inconsistent | Fully specialized |
| Aura and trigger capture | Often missing | Variable | Standardized |
| Medication overuse tracking | Not built-in | Rarely structured | Integrated |
| Documentation consistency | Moderate | Variable | High |
| Personalization to physician style | None | Low | High |
| E/M compliance support | Basic | Partial | Strong |
This general neurology SOAP note template is designed for clinicians documenting a broad range of neurological complaints, stroke, tremor, headache, and seizure,capturing history, neurological exam findings, and treatment plans in one structured format.
Link to the template
This template is designed for clinicians documenting seizure disorders, capturing seizure semiology, EEG and imaging findings, medication management, and SUDEP risk counseling for suspected or confirmed epilepsy.
Link to the template
This template is designed for clinicians documenting dizziness and balance disorders, capturing vertigo onset, triggers, nystagmus findings, and vestibular exam results alongside diagnosis and treatment planning.
Link to the template
This template is designed for neurologists managing movement disorders, capturing motor symptom progression, medication response (e.g., levodopa), UPDRS-type findings, and longitudinal disease tracking.
Link to the template
This template is designed for pediatric neurologists, capturing prenatal/birth history, developmental milestones, seizure and neurological exam findings, and family history specific to children presenting with neurological symptoms.
Link to the template
This template supports neurosurgeons in documenting presenting complaints, imaging findings, surgical planning, and post-operative follow-up across a range of neurosurgical cases.
Link to the template
This template is designed for sleep medicine visits, capturing sleep history, polysomnography findings, and treatment planning — relevant given how closely sleep disruption is tied to migraine frequency.
Link to the template
A migraine SOAP note template is a structured format used to document headache history, symptom patterns, triggers, and treatment plans using the SOAP framework. It ensures consistent capture of migraine-specific details like aura, frequency, and medication response, which improves diagnosis and supports accurate clinical documentation.
A migraine documentation template should include headache characteristics, aura history, associated symptoms, trigger patterns, medication use, disability scoring (MIDAS or HIT-6), neurological findings, and a clear treatment plan. These elements are essential for accurate diagnosis and ongoing management.
Frequency is documented as headache days per month, while severity is recorded using pain scales and disability tools like MIDAS or HIT-6 to assess overall impact.
Tracking triggers helps identify patterns such as stress, sleep changes, or diet, allowing for targeted preventive strategies and better long-term migraine control.
It organizes clinical data into a clear structure, helping clinicians evaluate patterns, adjust medications, and decide on preventive or acute treatment strategies.
General Medical DisclaimerThis content is for informational and educational purposes only and does not constitute medical advice, diagnosis, or treatment. Clinicians should use their professional judgment and follow applicable clinical guidelines when using any template.
Clinical Responsibility DisclaimerUse of this template does not replace independent clinical decision-making. The clinician remains fully responsible for the accuracy, completeness, and appropriateness of all documented information.
No Patient Relationship DisclaimerThis content does not establish a clinician–patient relationship. It is intended solely as a documentation reference for healthcare professionals.
Template Use DisclaimerThe templates provided are structural guides and may require modification based on specialty, patient context, and institutional requirements. They are not one-size-fits-all solutions.
Regulatory Compliance DisclaimerUsers are responsible for ensuring that documentation complies with local laws, licensing requirements, payer guidelines, and institutional policies.
Billing and Coding DisclaimerTemplates are not a substitute for proper coding knowledge. Clinicians must ensure that documentation meets requirements for E/M coding and reimbursement standards applicable in their region.
Data Privacy DisclaimerAny patient information documented using these templates must comply with applicable data protection regulations such as HIPAA or other regional privacy laws. Avoid including identifiable patient data in unsecured systems.
No Guarantee of Outcomes DisclaimerUse of these templates does not guarantee clinical outcomes, documentation acceptance, or reimbursement approval.
Third-Party Tools Disclaimer (Marvix AI)When using AI-assisted documentation tools such as Marvix AI, clinicians should review all generated content for accuracy and clinical appropriateness before finalizing records.
Jurisdictional Variation DisclaimerClinical documentation standards and legal requirements vary by country, state, and institution. Users should adapt templates accordingly.
Educational Use DisclaimerThese templates may be used for training, academic, or workflow optimization purposes but should be validated before use in real clinical environments.
Limitation of Liability DisclaimerThe creators of this content are not liable for any errors, omissions, or outcomes resulting from the use of these templates in clinical or administrative settings.
.png)
