Keep clean with SOAP notes

Posted On 2014-11-14 by dwirch
Tags: Blog Tip General 
Views: 1451

When I was a young IT professional, a more senior professional introduced me to SOAP notes for helping document and manage my my tickets. More than 25 years later, I still use this method, with great effect.

SOAP notes originally got their start in the health care field, and the notes were used by providers to create a patients chart. There are four parts to a SOAP note: Subjective, Objective, Assessment, and Plan.

These parts are very helpful in creating a record of what the patient is complaining about (Subjective), what the provider has observed about repeatable and traceable facts (such as vital signs or lab results) (Objective), the providers diagnosis (Assessment), and treatments and/or procedures to be performed (Plan). Note that the plan can include diagnostics to be performed as well.

I'm sure you can see how this method can be easily used to great effect in an technology support enuvironment. Let's walk through a sample of a tech-style SOAP note, and pretend SuzyUser is calling the helpdesk because she is unable to connect to a particular application. A SOAP note documentation set written by the help desk agent (TechDude) might look like this:


User (SuzyUser) has called stating that she is unable to login to AppX. She states that she has rebooted her local computer, but is still unable to login.


I (TechDude) asked the user to attempt login to AppX. Witnessed error code [Invalid Username or Password].

Verified error message by checking log mechanism on AppX.


User (SuzyUser) needs to enter a correct username and password combination in order to successfully login to AppX.


  1. Ensure that SuzyUser is using the correct username and password combination.
  2. If SuzyUser has forgotten the correct username and/or password, reset password, following password guidelines.
  3. After password reset, SuzyUser to attempt login again with correct username and password combination.
  4. Observe results:
    1. If successful, close ticket as resolved.
    2. If not successful, forward ticket to tier 2 support, attaching pertinent AppX log file excerpt.

In this sample, the tech professional documented the problem from the user point of view, noted the observations of the problem in a repeatable manner, diagnosed the problem, and documented both a primary and secondary plan of action. While this example is admittedly a simple one, we've now got a completely documented case, which can be used to solve or troubleshoot future issues of the same type. And we all know that documentation is a good thing, right ?

You may or may not use a method similar to this. What method do you use for documenting problems?

About the Author

dwirch has posted a total of 172 articles.


Comments On This Post

No comments on this post yet!

Do you have a thought relating to this post? You can post your comment here. If you have an unrelated question, you can use the Q&A section to ask it.

Or you can drop a note to the administrators if you're not sure where you should post.

Your IP address is:

Before you can post, you need to prove you are human. If you log in, this test goes away.

Recent Forum Posts

Job Spammer: Sathya Narayana
dwirch posted on March 15, 2017 at about 7:18 in Spammers

Job Spammer: Manish Kumar
dwirch posted on March 14, 2017 at about 17:44 in Spammers

Site Migration Complete
dwirch posted on March 12, 2017 at about 11:10 in Site News

Site Migration Complete
dwirch posted on March 11, 2017 at about 0:35 in Site News

Job Spammer: Jason Weinstein
dwirch posted on March 10, 2017 at about 14:00 in Spammers

Job Spammer: Ryan Wilson
dwirch posted on March 8, 2017 at about 17:00 in Spammers