domains / families / devops / odoo-migration-helper

odoo-migration-helper

authentic

Step-by-step guide for migrating Odoo custom modules between versions (v14→v15→v16→v17). Covers API changes, deprecated methods, and view migration.

When to use

• Upgrading a custom module from Odoo 14/15/16 to a newer version.
• Getting a checklist of things to check before running `odoo-upgrade`.
• Fixing deprecation warnings after a version upgrade.
• Understanding what changed between two specific Odoo versions.

When not to use

• Covers **v14 through v17** only — does not address v13 or older (pre-manifest era has fundamentally different module structure).
• The **Odoo.sh automated upgrade** path has additional steps not covered here; refer to Odoo.sh documentation.
• **Enterprise-specific modules** (e.g., `account_accountant`, `sign`) may have undocumented breaking changes; test on a staging environment with Enterprise license.
• JavaScript OWL component migration (v15 Legacy → v16 OWL) is a complex topic not fully covered by this skill.

Skill page

Source