Odoo Migration Helper

Key Migration Changes by Version

Odoo 16 → 17

Odoo 15 → 16

Examples

Example 1: Migrate attrs visibility to Odoo 17

<!-- v16 — domain-based attrs -->
<field name="discount" attrs="{'invisible': [('product_type', '!=', 'service')]}"/>
<field name="discount" attrs="{'required': [('state', '=', 'sale')]}"/>

<!-- v17 — inline Python expressions -->
<field name="discount" invisible="product_type != 'service'"/>
<field name="discount" required="state == 'sale'"/>

Example 2: Migrate Chatter block

<!-- v16 -->
<div class="oe_chatter">
    <field name="message_follower_ids"/>
    <field name="activity_ids"/>
    <field name="message_ids"/>
</div>

<!-- v17 -->
<chatter/>

Example 3: Migrate website_published flag (v15 → v16)

# v15
record.website_published = True

# v16+
record.is_published = True

Best Practices

• ✅ Do: Test with --update=your_module on each version before pushing to production.
• ✅ Do: Use the official Odoo Upgrade Guide to get an automated pre-upgrade analysis report.
• ✅ Do: Check OCA migration notes and the module's HISTORY.rst for community modules.
• ✅ Do: Run npm run validate after migration to catch manifest or frontmatter issues early.
• ❌ Don't: Skip intermediate versions — go v14→v15→v16→v17 sequentially; never jump.
• ❌ Don't: Forget to update version in __manifest__.py (e.g., 17.0.1.0.0).
• ❌ Don't: Assume OCA modules are migration-ready; check their GitHub branch for the target version.

Limitations

• 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.