n8n Migration Guidelines

Rule of thumb: the @n8n-io/migrations-review team gates every migration PR. The fixes they ask for are predictable — work through the Pre-flight checklist before requesting review. The rest of this document explains the why for each item and covers deeper topics.

Table of Contents

• Overview
• Pre-flight checklist
• Common Guidance
• Schema Migrations
• Data Migrations
• Cross-database Compatibility
• Tests
• General Design Guidance
• After authoring