n8n Troubleshooting
Debugging n8n workflows and handling errors.
Articles in n8n Troubleshooting
- n8n Paired Items (Item Linking) Explained: Why .item Breaks and How to Fix It — How n8n links each output item to the input that produced it, the exact cases where automatic linking fails, the three item-linking errors (missing info, multiple matches, another branch) and their fixes, pairedItem and itemMatching in the Code node, and how to avoid the problem.
- n8n Executions Panel: Debugging Failed Runs and Managing Data Retention — The Executions list is where every past workflow run lives -- and where most debugging actually happens. A guide to reading execution data, manually retrying a failed run, and the retention settings that determine how much history you keep.
- Compensating Actions: What to Do When Step 3 of a 5-Step AI Automation Fails — A five-step automation that fails on step three doesn't leave you at step two — it leaves you with two completed side effects and no built-in way to undo them.
- n8n Pin Data: Testing Workflows Without Re-Triggering Paid API Calls — Every time you tweak a downstream node, n8n re-runs everything upstream too — including the OpenAI or Claude call you're paying for. Pin Data fixes that.
- n8n Expressions Explained: How Items Work and the Mistakes That Break Them — The data model behind n8n expressions ($json, $input, $('Node').item and .first(), $now) and fixes for the mistakes it explains: wrong node, missing fields, unexecuted branches, string numbers, hand-formatted dates and whole-list logic.
- Debugging an n8n Workflow That Works Manually but Fails on Trigger — It's one of the most disorienting n8n bugs: click "Execute Workflow" and everything works, but the live trigger fails silently. It's almost always one of four specific causes.
- Why Your n8n AI Agent Node Stops Following Its System Prompt After an Update — An n8n update quietly changed how the AI Agent node merges system messages — here's the exact cause and the five-minute fix.
- n8n Error Handling: A Complete Guide to Reliable Workflows — How to build n8n workflows that fail safely: the On Error setting, Retry On Fail and its limits, error workflows and Stop And Error, plus a logging pattern that catches failures before they turn into silent outages.