DEV Community

jamil fayad
jamil fayad

Posted on

A review checklist for n8n workflows before you release them

Before you hand an n8n workflow to a client or switch it on, it is easy to
check that it runs and still miss the cases that hurt later. This is the
checklist I use, with what each step is meant to catch. It is a review aid,
not a guarantee that a workflow is safe.

1. Keep the original and name the target environment

Save an untouched export. Note the n8n version, node versions, destination
accounts and who can approve changes, so every edit can be compared with the
original and restored.

2. Review credentials and external actions

Check credential references, HTTP headers and what each node is allowed to do.
Sanitise a separate copy before sharing it. Messages, bookings and record
changes should have explicit approval rules.

3. Validate missing and unexpected input

List required fields and test missing values and malformed data. Decide what
goes to a person rather than guessing a value.

4. Test repeated requests

Define what makes one request unique, run a fictional request twice, and
inspect the destination, not just the execution status.

5. Exercise failed and uncertain responses

Test a failed destination, a timeout and an ambiguous acknowledgement in an
isolated environment, with bounded retries and a manual fallback.

6. Review the diff, then test behaviour

Treat analyzer findings as prompts for review. Re-check each changed field and
test the whole workflow with fictional data and test accounts.

What this does not cover

The checklist does not establish security, successful execution or time
savings. I wrote it alongside a small Python analyzer I built for n8n
workflow JSON; in one local run on a 16-node sample it reported 11 findings
and applied 5 schema edits, and it also produced a false positive and missed
a check, which are documented on the page below.

Full checklist with acceptance checks and limits:
https://jamilfayad.com/insights/n8n-workflow-review-checklist.html
Analyzer write-up and source:
https://jamilfayad.com/projects/n8n-workflow-autofix.html

Top comments (0)