Troubleshooting guide template: free, editable diagram
Check, fix, confirm, or escalate with notes. This starter has 10 steps and 2 decision points. Open it as a real canvas with shapes and arrows you can restyle, extend and share, then turn the action steps into tasks.
Free. No account needed. Saved in this browser until you sign up.
What is in this template
10 steps, 2 of them decisions, in diagram order. Rename, remove or add branches once it is on your canvas.
- 1Something is not working
- 2Check the basics
- 3Fixed?
- 4Resolved
- 5Look at logs and recent changes
- 6Try the most likely fix
- 7Fixed now?
- 8Write down what worked
- 9Escalate with notes
- 10Resolved and documented
Get the Mermaid source
Mermaid source
flowchart TD
symptom([icon:alert-circle Something is not working]) ==> basics[icon:player-play Check the basics]
basics ==> fixed{Fixed?}
fixed -->|yes| done([icon:circle-check Resolved])
fixed ==>|no| logs[icon:file-search Look at logs and recent changes]
logs ==> attempt[icon:wand Try the most likely fix]
attempt ==> works{Fixed now?}
works ==>|yes| document[icon:pencil Write down what worked]
works -->|no| escalate[icon:arrow-up-right Escalate with notes]
document ==> documented([icon:book Resolved and documented])
classDef tone-danger fill:#fee2e2
class symptom,escalate tone-danger
classDef tone-info fill:#dbeafe
class basics,logs,attempt tone-info
classDef tone-warning fill:#fef3c7
class fixed,works tone-warning
classDef tone-success fill:#dcfce7
class done,document,documented tone-successPaste it into the free Mermaid editor or your own docs.
Questions
- What is the troubleshooting guide template?
- Check, fix, confirm, or escalate with notes. It is a starting diagram you adapt to your own process.
- Can I edit it?
- Yes. It opens as normal shapes and bound arrows: rename steps, add branches, restyle, and collaborate live once you have an account.
- Do I need an account?
- No. You can open it in a guest canvas saved in your browser. Create an account to keep it and share it.