Substance Use Disorder Documentation: SOAP Notes & MAT Progress Notes
Dr. Medeline Yost
Chief Medical Officer, Augustun
Published July 11, 2026
Updated July 11, 2026
On this page
- Why SUD Notes Matter Clinically and Regulatorily
- What to Document in Every SUD Encounter
- MAT Documentation: Buprenorphine and Naltrexone
- COWS and CIWA When Relevant
- UDS Interpretation Without Stigma
- Dual Diagnosis Documentation Tips
- SOAP / MAT Progress Note Template
- Four SOAP Examples
- Contingency Planning and Safety
- Common Mistakes in SUD Documentation
- Let an AI Scribe Draft Your SUD and MAT Notes
- Conclusion
- FAQ
Substance use disorder (SUD) documentation sits at the intersection of clinical care and regulatory accountability. A progress note for a person with opioid use disorder (OUD) on buprenorphine, or a person with alcohol use disorder (AUD) starting naltrexone, must show medical necessity, track adherence and counseling, and — when relevant — document withdrawal severity, urine drug screen (UDS) results, and safety planning. Vague language and stigmatizing phrasing weaken both care continuity and audit readiness.
Unlike a brief primary-care refill note, SUD and medication-assisted treatment (MAT) notes often need enough detail for DEA or state program review, payer medical-necessity checks, and the next clinician who may see the person in crisis. Done well, the note captures substance, amount and frequency, last use, withdrawal and cravings, psychosocial context, and readiness to change — without reducing the person to a label.
This guide walks through what belongs in SUD SOAP and MAT progress notes, how to document buprenorphine and naltrexone, when to use COWS or CIWA, how to interpret UDS without stigma, dual diagnosis tips, a fillable template, and four complete examples. For the broader psychiatric SOAP structure these notes build on, see our guide to the psychiatric SOAP note.
Why SUD Notes Matter Clinically and Regulatorily
An SUD note is a clinical document first: it records the person's reported use, your observations, your diagnostic impression, and the treatment plan. It is also a regulatory document. Outpatient MAT for OUD, counseling requirements tied to buprenorphine prescribing, and controlled-substance prescribing all depend on a chart that shows you assessed risk, offered counseling or referral, monitored adherence, and responded to concerning findings.
Person-first language belongs in the record as much as in the room. Prefer 'person with OUD' or 'person with stimulant use disorder' over 'addict' or 'abuser.' Prefer 'return to use' or 'recurrence' over 'relapse' when your setting uses recovery-oriented language — or, if you use 'relapse,' define it clinically (e.g., return to daily heroin use after three months of abstinence). Prefer 'positive UDS for cannabis' over 'dirty urine.' Stigma in the chart can shape how future teams treat the person and how the person experiences care.
What to Document in Every SUD Encounter
Whether the visit is an intake or a brief MAT follow-up, these elements should appear when clinically relevant. Missing them is one of the most common reasons SUD notes fail medical-necessity or program review.
- Substance(s) — primary substance and any co-occurring substances (alcohol, opioids, stimulants, benzodiazepines, cannabis, nicotine, other)
- Amount and frequency — approximate dose or quantity, route, and how often; note changes since last visit
- Last use — date and time of last use for each relevant substance; critical for withdrawal risk and induction timing
- Withdrawal — subjective symptoms and objective signs; score with COWS or CIWA when indicated
- Cravings — intensity (e.g., 0–10), triggers, and coping used
- Psychosocial context — housing, employment, legal involvement, relationships, trauma history when it informs care
- Readiness to change — stage of change, goals the person states in their own words, ambivalence if present
Also document overdose history, naloxone access and teaching, and any high-risk use patterns (injecting alone, mixing opioids with benzodiazepines or alcohol). Link functional impact to medical necessity the way you would in a depression progress note: missed work, strained relationships, medical complications, or impaired parenting capacity when relevant.
MAT Documentation: Buprenorphine and Naltrexone
Medication for addiction treatment (MAT) — including buprenorphine/naloxone for OUD and naltrexone (oral or extended-release injectable) for OUD or AUD — requires documentation that shows dosing, adherence, counseling or behavioral support, and response. Treat MAT notes with the same rigor you use for a psychiatric medication management note.
Buprenorphine / buprenorphine-naloxone
- Formulation, dose, frequency, and route (e.g., buprenorphine-naloxone 8/2 mg SL BID)
- Induction vs maintenance; days since last full-agonist use if inducting
- Adherence (doses taken as prescribed; diversion or misuse concerns addressed factually)
- Side effects (constipation, sedation, precipitated withdrawal if applicable)
- Counseling or behavioral therapy offered, accepted, declined, or referred — and why
- PDMP review when required or clinically appropriate, with date reviewed
- Naloxone prescribed or confirmed on hand; overdose education documented
Naltrexone (oral or XR-injectable)
- Indication (OUD, AUD, or both) and formulation
- For XR-naltrexone: injection date, site, next due date; for oral: daily adherence
- Opioid-free interval before start when treating OUD; naloxone challenge if used
- Hepatic labs when clinically indicated; counseling on opioid blockade and acute pain planning
- Craving reduction and drinking or opioid-use days since last visit
Counseling is part of the note, not an afterthought
Document what counseling was provided in-visit (motivational interviewing, relapse-prevention skills, contingency discussion) or the external counseling/IOP referral status. 'Continue MAT' alone rarely satisfies reviewers who expect behavioral support to be addressed.
COWS and CIWA When Relevant
Standardized withdrawal scales turn subjective discomfort into auditable numbers and guide dosing decisions. Use them when the person may be in opioid or alcohol withdrawal — and document the score, the items driving it, and how the score changed your plan.
| Scale | Use when | What to document |
|---|---|---|
| COWS (Clinical Opiate Withdrawal Scale) | Suspected or known opioid withdrawal; buprenorphine induction | Total score, key signs (pupil size, yawning, GI, restlessness), timing relative to last use and dose given |
| CIWA-Ar (Clinical Institute Withdrawal Assessment for Alcohol) | Alcohol withdrawal risk or active withdrawal | Total score, tremor, autonomic signs, orientation, hallucinations if present, benzodiazepine protocol response |
A note that says 'mild withdrawal' without a score is harder to defend than 'COWS 14 — moderate; inducted with buprenorphine-naloxone 4/1 mg SL after confirming last heroin use ~18 hours ago; recheck COWS in 45–60 minutes.'
UDS Interpretation Without Stigma
Urine drug screens are clinical data, not moral tests. Document the panel ordered, the result, immunoassay vs confirmatory testing when relevant, prescribed medications that may explain positives, and your clinical interpretation tied to the treatment plan — not character judgments.
- State results factually: 'UDS immunoassay positive for opioids and buprenorphine; negative for cocaine, amphetamines, benzodiazepines, cannabis.'
- Reconcile with the prescribed regimen: expected buprenorphine positive on MAT; unexpected cocaine positive warrants a nonjudgmental discussion and plan adjustment
- Note limitations: immunoassay false positives/negatives; timing of last use; synthetic opioids that may not appear on standard panels
- Document the conversation and shared plan: increased visit frequency, counseling intensification, dose review — not punitive language
- Avoid 'dirty' / 'clean' and 'noncompliant addict' framing; prefer 'unexpected positive for X; discussed with patient; plan as follows'
Dual Diagnosis Documentation Tips
Co-occurring SUD and psychiatric disorders are common. Document both diagnoses with supporting criteria, clarify which symptoms are attributed to intoxication or withdrawal versus an independent mood or psychotic disorder when you can, and show that the plan addresses both. See also how to write psychiatry notes for MSE and risk structure.
- List SUD and psychiatric diagnoses separately with ICD-10 codes (e.g., OUD, moderate, on maintenance therapy; MDD, recurrent, moderate)
- Note temporal relationships: mood symptoms that persist weeks into abstinence vs symptoms that clear with detox
- Screen and document SI/HI every visit — substance use elevates risk; do not skip because the visit 'was only MAT'
- Avoid collapsing everything into 'substance-induced' without evidence; document differentials (R/O substance-induced depressive disorder vs primary MDD)
- Coordinate care: name the therapist, IOP, primary care, or peer support involved when known
SOAP / MAT Progress Note Template
Use this as a fillable skeleton for outpatient SUD and MAT visits. Trim sections that do not apply; expand withdrawal and UDS blocks when they drive the visit.
SUD / MAT SOAP Note — Template
- S (Subjective)
- Chief concern in the person's words. Substances: type, amount, frequency, route, last use. Cravings (0–10) and triggers. Withdrawal symptoms reported. MAT adherence and side effects. Psychosocial stressors and supports. Counseling engagement. Goals / readiness. Overdose risk factors and naloxone access. SI/HI screen in their words when endorsed.
- O (Objective)
- Appearance, behavior, speech, mood/affect, thought process/content, perception, cognition, insight/judgment (MSE). Vitals. COWS or CIWA score when indicated. UDS / labs / PDMP findings. Signs of intoxication or withdrawal. Injection-site or skin findings if relevant.
- A (Assessment)
- SUD diagnosis(es) with severity and course (e.g., on maintenance therapy, in early remission). MAT response and adherence impression. Co-occurring psychiatric diagnoses. Withdrawal severity if scored. UDS interpretation. Risk formulation (overdose, SI/HI) with risk and protective factors. Medical necessity for continued MAT / counseling.
- P (Plan)
- Medication: continue / adjust / induct with dose and rationale. Counseling or referral. Labs / UDS / PDMP schedule. Naloxone and overdose education. Contingency / safety plan. Follow-up interval and what will be reassessed.
Four SOAP Examples
Names and details are illustrative. Adapt the structure to your setting and local documentation requirements.
Example 1 — OUD Buprenorphine Follow-Up
Jordan is a 34-year-old person with OUD returning for a routine MAT follow-up on buprenorphine-naloxone.
SUD SOAP Note — OUD Buprenorphine Follow-Up
- S (Subjective)
- 34-year-old with OUD returns for 4-week MAT follow-up. Reports taking buprenorphine-naloxone 8/2 mg SL BID as prescribed; no missed doses. Last heroin use 'about three months ago.' Cravings 2/10, mostly when passing the old neighborhood. Sleeping well; mild constipation managed with fiber. Attending weekly counseling. States, 'I feel steady — I just want to keep going.' Denies alcohol, benzodiazepines, or cocaine. Naloxone kit at home; partner trained. Denies SI/HI.
- O (Objective)
- Well-groomed, calm, good eye contact. Speech normal. Mood 'okay'; affect congruent and full. Thought process linear; no psychosis. Insight good; judgment intact. No signs of intoxication or withdrawal. Pupils normal. Vitals: BP 122/78, HR 76. UDS (immunoassay): positive for buprenorphine; negative for opioids (other), cocaine, amphetamines, benzodiazepines, cannabis. PDMP reviewed today: buprenorphine only from this clinic.
- A (Assessment)
- 1) Opioid use disorder, severe, on maintenance therapy (F11.20) — stable on buprenorphine-naloxone; UDS consistent with prescribed regimen; no return to heroin use reported. 2) Constipation, medication-related, mild. Overdose risk: low at present given adherence, no polysubstance use reported, naloxone available. Suicide risk: denies ideation — low acute risk. Continued MAT and counseling medically necessary for relapse prevention and functional stability (returned to work).
- P (Plan)
- Continue buprenorphine-naloxone 8/2 mg SL BID. Continue weekly counseling; reinforced craving coping plan. Continue fiber; add OTC stool softener PRN. Naloxone refill if needed. Repeat UDS next visit. Follow-up in 4 weeks; sooner if cravings escalate or return to use.
Example 2 — AUD Medication Management
Priya is a 48-year-old person with AUD starting naltrexone after a recent increase in drinking.
SUD SOAP Note — AUD Naltrexone Start
- S (Subjective)
- 48-year-old with AUD presents for medication management. Reports drinking 8–10 standard drinks most evenings for the past 6 weeks after a job loss; previously 3–4 drinks 2–3 nights/week. Last drink last night ~10 pm. States, 'I want to stop before I lose my marriage.' Mild morning tremor and anxiety; no seizures or DTs historically. Interested in naltrexone; prefers oral first. Attending AA 2x/week. Denies opioid use. Denies SI/HI; 'I wouldn't do that to my kids.'
- O (Objective)
- Anxious appearing, mild resting tremor of hands, no diaphoresis. Speech normal. Mood 'scared and motivated'; affect anxious but reactive. Thought process linear. Oriented x3; cognition intact. Insight good. CIWA-Ar = 8 (mild) — tremor and mild anxiety drive score; no hallucinations. Vitals: BP 138/88, HR 92. Recent CMP: AST 68, ALT 52; otherwise unremarkable. UDS negative for opioids.
- A (Assessment)
- 1) Alcohol use disorder, severe (F10.20) — escalating use, functional impact (job loss, marital strain), motivated for pharmacotherapy. 2) Mild alcohol withdrawal (CIWA-Ar 8) — outpatient-manageable at present; no history of complicated withdrawal. Hepatic enzymes mildly elevated, consistent with recent heavy drinking; naltrexone still reasonable with monitoring. Suicide risk: denies ideation; protective factors include children and treatment engagement — low acute risk. Medical necessity: MAT (naltrexone) plus psychosocial support to reduce heavy drinking days and prevent worsening withdrawal risk.
- P (Plan)
- Start naltrexone 50 mg oral daily after discussing opioid blockade, hepatic monitoring, and not using opioids for pain without telling providers. Reviewed early withdrawal warning signs; return to ED if CIWA symptoms worsen (severe tremor, confusion, hallucinations). Continue AA; referral to outpatient SUD counseling. Thiamine and multivitamin. Repeat CMP in 4–6 weeks. Safety: crisis resources provided. Follow-up in 1 week for adherence, drinking days, and CIWA reassessment if symptomatic.
Example 3 — Stimulant Use Disorder, Psychiatry Visit
Marcus is a 29-year-old person with methamphetamine use disorder seen in outpatient psychiatry for mood and use-related insomnia.
SUD SOAP Note — Stimulant Use Disorder Psych Visit
- S (Subjective)
- 29-year-old with methamphetamine use disorder returns for psychiatry follow-up. Reports smoking meth 'a couple times a week' — down from daily last month. Last use 2 days ago. Sleeps 3–4 hours after use nights; 'I'm fried at work.' Cravings 6/10 when stressed. No opioids or benzodiazepines. States, 'I know it's messing me up, but quitting cold feels impossible.' Mild paranoia after heavy use last month, now resolved per patient. Denies current hallucinations. Passive SI last week ('maybe it'd be easier if I wasn't around') without plan or intent; now denies SI. Contemplative stage of change.
- O (Objective)
- Thin, mildly restless, poor sleep hygiene appearance (tired). Speech slightly rapid but interruptible. Mood 'wired and down'; affect labile. Thought process goal-directed; no delusions today. No AH/VH. Oriented x3; attention mildly impaired. Insight fair; judgment fair. No acute intoxication. UDS: positive for amphetamines; negative for opioids, cocaine, benzodiazepines, cannabis. BP 142/90, HR 98.
- A (Assessment)
- 1) Stimulant use disorder (methamphetamine), moderate (F15.20) — reduced frequency but ongoing use, cravings, occupational impairment, recent substance-related paranoia now resolved. 2) Insomnia, substance-related. 3) R/O stimulant-induced mood disorder vs primary depressive symptoms — defer independent MDD diagnosis until longer abstinence window; monitor closely. Suicide risk: recent passive ideation, now denied; no plan/intent; risk elevated in context of ongoing stimulant use — low-to-moderate; safety plan updated. No FDA-approved MAT specific to stimulant use disorder; contingency management / CBT and sleep stabilization are primary.
- P (Plan)
- Motivational interviewing this visit; patient agreeable to contingency-management referral and weekly therapy focused on cue coping. Sleep hygiene; short-term trazodone 50 mg qHS for insomnia with discussion of risks/benefits. No stimulant or benzodiazepine prescriptions. Naloxone not indicated for stimulant-only use; overdose education on polysubstance risk if opioids ever co-used. Safety plan reviewed; crisis line provided; patient agrees to contact supports if passive SI returns. Follow-up in 2 weeks; sooner if paranoia or SI returns. UDS next visit.
Example 4 — Dual Diagnosis: SUD + MDD
Elena is a 41-year-old person with OUD on buprenorphine and recurrent major depression, illustrating how both tracks appear in one note.
SUD SOAP Note — Dual Diagnosis OUD + MDD
- S (Subjective)
- 41-year-old with OUD and recurrent MDD returns for combined MAT and med-management visit. Buprenorphine-naloxone 12/3 mg SL daily — adherent. No opioid use in 8 months. Cravings 1/10. Depression worse x3 weeks: anhedonia, sleep-onset insomnia, guilt, low energy. PHQ-9 self-score today 17 (was 9 three months ago). States, 'The bup is fine — it's my mood that's falling apart.' Continues sertraline 100 mg; thinks it 'stopped working.' Therapy biweekly. Denies SI/HI today; history of one overdose 2 years ago (intentional, while using). Naloxone at home.
- O (Objective)
- Casually dressed, tearful at times, psychomotor slowing. Speech soft, normal rate. Mood 'depressed'; affect constricted and congruent. Thought process linear; no psychosis. Insight good; judgment intact. No withdrawal signs. UDS: positive for buprenorphine only. PHQ-9 = 17. Vitals stable.
- A (Assessment)
- 1) Opioid use disorder, severe, on maintenance therapy (F11.20) — stable MAT response; UDS consistent; low craving. 2) Major depressive disorder, recurrent, moderate (F33.1) — worsening depressive syndrome despite ongoing abstinence from opioids, supporting primary MDD rather than solely substance-induced mood disorder at this time. Partial response / loss of response to sertraline 100 mg. Suicide risk: denies current ideation; remote intentional overdose in context of use; protective factors include treatment engagement, children, naloxone access — low-to-moderate; warrants close monitoring given PHQ-9 rise. Both conditions require active management; depression treatment intensification medically necessary.
- P (Plan)
- Continue buprenorphine-naloxone 12/3 mg daily. Increase sertraline to 150 mg daily for breakthrough depressive symptoms; discussed side effects and timeline. Continue therapy; therapist notified of PHQ-9 increase (with patient consent). Safety plan reviewed; crisis resources provided. Repeat PHQ-9 next visit. UDS and MAT adherence check next visit. Follow-up in 2 weeks.
Contingency Planning and Safety
Every SUD note should show that you thought ahead about overdose, return to use, and psychiatric crisis — not only today's dose.
- Overdose: naloxone prescribed or confirmed; who was educated; risk of solitary use and polysubstance combinations
- Return-to-use plan: what the person will do if they use again (call clinic, do not use alone, resume MAT promptly) — framed without shame
- Acute pain / surgery: for people on naltrexone or buprenorphine, document counseling about informing other clinicians
- Psychiatric safety: SI/HI every visit; means restriction when relevant; crisis contacts
- Missed visits / unexpected UDS: what the clinic will do (earlier follow-up, counseling intensification) documented as a clinical response, not a punishment narrative
Common Mistakes in SUD Documentation
Stigmatizing or vague language
'Chronic abuser, noncompliant, dirty UDS' communicates judgment and little clinical detail. Prefer person-first terms, specific substances and amounts, and factual UDS interpretation tied to a plan.
Missing last use, amount, and frequency
Without last use and quantity, withdrawal risk and induction timing cannot be reconstructed. Reviewers and covering clinicians need those numbers.
MAT without counseling or behavioral support documented
Even a brief MI intervention or a declined referral should appear in the note. Silence looks like an incomplete plan.
Skipping risk because 'it was only a refill'
Overdose and suicide risk change quickly in SUD populations. A documented negative ('denies SI/HI; naloxone at home') is protective and clinically useful.
UDS as punishment
Unexpected positives should trigger assessment and care adjustment, not chart language that shames the person. Document the discussion and the clinical next step.
Ignoring dual diagnosis
Treating only the substance or only the mood disorder in the note leaves medical necessity incomplete when both are active. Name both and show the plan addresses both.
Let an AI Scribe Draft Your SUD and MAT Notes
SUD visits move fast: last use, cravings, COWS items, UDS review, MAT dosing, counseling, and safety all need to land in the chart before the next person is roomed. Augustun for psychiatry listens during the encounter and drafts a structured SOAP or medication-management note — including substance history details, MSE, and a clear plan — so you can stay present with the person in front of you. You review, edit, and sign.
Augustun supports SOAP and related behavioral-health formats, can draft patient instructions and follow-up plans, and connects to 400+ EHRs through a browser extension so finished notes land where you already chart. It is built for clinical use with HIPAA compliance, and recordings are never stored.
Built for behavioral health documentation
Whether you are documenting buprenorphine follow-up, AUD medication starts, or dual diagnosis visits, Augustun adapts to your format. Pair this guide with the psychiatric SOAP note template for MSE and risk structure.
AI-Powered · HIPAA-Ready
Document SUD visits without losing the clinical thread
Try Augustun on your next MAT or dual diagnosis encounter — ambient capture, structured SOAP drafts, and EHR-ready notes you review before signing.
No credit card required.
Conclusion
Strong substance use disorder documentation is precise, person-first, and complete enough for both the next clinician and a regulatory reviewer. Capture substance, amount, frequency, last use, withdrawal, cravings, psychosocial context, and readiness. For MAT, document dose, adherence, counseling, and monitoring. Score COWS or CIWA when withdrawal drives decisions. Interpret UDS as clinical data. Address dual diagnosis and safety every time.
Start from the template above, adapt one of the four examples, and build the habit of nonstigmatizing, medically necessary notes. Whether you write them yourself or let an AI scribe draft them for review, clear SUD documentation is part of the care you deliver — not just paperwork after the visit.
Frequently asked questions
What should every substance use disorder progress note include?
At minimum: substances used, amount and frequency, last use, withdrawal and craving status, relevant psychosocial factors, readiness or goals, an objective exam (including MSE when it is a psychiatry visit), assessment with diagnoses, and a plan covering medication, counseling, monitoring, and safety. For MAT visits, add dose, adherence, side effects, and counseling or referral status.
How do you document buprenorphine or naltrexone (MAT) visits?
Document the formulation and dose, adherence, side effects, clinical response (use days, cravings), counseling or behavioral support, relevant labs or UDS, PDMP review when applicable, naloxone access for opioid risk, and the follow-up plan. For inductions, include last full-agonist use timing and COWS when used to guide dosing.
When should COWS or CIWA be documented?
Document COWS when assessing opioid withdrawal or inducting buprenorphine. Document CIWA-Ar when assessing alcohol withdrawal severity or guiding outpatient vs higher-level care. Record the total score, key contributing items, and how the score changed your plan.
How should urine drug screen results be written in the chart?
State the panel and results factually, reconcile positives with prescribed medications, note assay limitations when relevant, and document the clinical discussion and plan. Avoid stigmatizing terms such as 'dirty' or 'clean.' Unexpected positives should prompt care adjustment, not punitive chart language.
Can an AI scribe help with SUD and MAT documentation?
Yes. An ambient AI scribe like Augustun can draft structured SOAP or medication-management notes from the visit conversation — including substance history details, MSE, and plan items — for you to review and sign. It is HIPAA compliant, does not store recordings, and can push finished notes into your EHR workflow via browser extension.
AI-Powered · HIPAA-Ready
Spend more time with patients, not paperwork.
Augustun transforms ambient speech into accurate notes — finished before your next session.
No credit card required.

Dr. Medeline Yost
Chief Medical Officer, Augustun
Dr. Medeline Yost is an Internal Medicine physician and an emerging leader in clinical innovation. As Chief Medical Officer at Augustun, she helps shape AI-powered tools that streamline clinical documentation and support physicians in delivering higher-quality care. Her professional interests include medical education, workflow redesign, and the responsible use of AI in healthcare — building systems that let clinicians spend more time with patients and less on administrative tasks.