I import-tested 3 n8n workflow templates like they were going to clients. Here's the checklist I use.

Description and use

The author validates n8n workflow templates in a clean environment, fixes bugs, and offers a checklist to ensure client readiness.

Problem

Workflow templates for sale often fail on real deployments because they are only tested in the author’s environment.

Outcome

The author identified eight bugs across three templates, fixed them, and produced a reusable checklist that ensures templates are client‑ready.

Workflow

• Spin up a clean‑room n8n 2.42.5 Docker instance with no credentials or extensions.
• Import the workflow via CLI (n8n import:workflow) and verify zero import errors.
• Walk every branch of every If/Switch node and confirm each branch can execute.
• Search the JSON for {{ placeholders that survive import and ensure each is interpolated or documented.
• Confirm no node writes outside allowed paths (e.g., /tmp is blocked in n8n 2.x).

Evidence

Most workflow templates for sale are hello‑world demos: they import, the canvas looks nice, and the first real run explodes.

Source

Clean‑room n8n instance. I spun up n8n 2.42.5 in Docker — no credentials, no prior workflows, no extensions.

Source

Import via the CLI (n8n import:workflow) with no credentials attached. It must import clean — zero errors — before anything else.

Source

Walk every branch of every If/Switch node and confirm each branch actually executes.

Source

Grep the JSON for {{ placeholders that survive import. Every one must either interpolate from a config node or be documented in the README as buyer setup.

Source

Confirm no node writes outside allowed paths. n8n 2.x blocks /tmp by default, so a template that writes there works on the author's machine and nowhere else.

Source

An If-node routed on largerEquals / smallerEquals operators that don't exist in n8n. The condition silently evaluated so the workflow always took the after-hours branch — the entire AI-reply path could never fire.

Source

The workflow wrote its CSV to /tmp, which n8n 2.x blocks by default. Changed to a documented, allowed location.

Source

Each pack goes out as workflow.json + README + per-credential setup guide + demo script, with sticky-note documentation inside the workflow itself.

Source