Skip to content

Odoo 15 to 16 Migration Guide: Loyalty Engine and Breaking Changes

DeployMonkey Team · March 24, 2026 7 min read

Overview

The Odoo 15 to 16 migration centers on the unified loyalty/coupon engine replacement. If you use coupons, promotions, or loyalty programs, this migration requires significant attention. Otherwise, it is a relatively smooth upgrade with mostly additive changes.

Loyalty Engine Migration

The most impactful change: Odoo 16 replaces multiple coupon/promotion modules with a single unified loyalty engine.

Modules Replaced

  • coupon -> loyalty
  • sale_coupon -> sale_loyalty
  • website_sale_coupon -> website_sale_loyalty
  • pos_coupon -> pos_loyalty (enhanced)

Data Migration

Existing coupon programs, coupon codes, and active coupons need migration to the new loyalty model. The database structure is different — coupon programs become loyalty programs with different rule and reward structures. Odoo's migration scripts handle standard data, but custom coupon logic requires manual migration.

Custom Coupon Code

Any custom module that extends coupon.program, coupon.coupon, or related models needs rewriting for the new loyalty.program, loyalty.card, loyalty.rule, and loyalty.reward models.

New Features to Leverage

Knowledge App (Enterprise)

New article-based knowledge management system. If you used third-party wiki or knowledge base modules, consider migrating to the native Knowledge app.

Spreadsheet Dashboards

New spreadsheet and spreadsheet_dashboard modules in Community Edition. These may replace custom dashboard solutions or third-party reporting modules.

Data Recycle

New data_recycle module for automated data cleanup. Useful for organizations with data governance requirements.

Website Builder Changes

The website builder received a major UI overhaul with a new snippet system. Custom website themes and snippets may need adaptation for the new editing experience. Test all custom website elements thoroughly.

Other Changes

  • Dark mode support added — test custom CSS for dark mode compatibility
  • Onboarding framework (onboarding module) — can replace custom onboarding wizards
  • European e-invoicing (account_edi_ubl_cii) — check if it replaces custom e-invoicing

Migration Steps

  1. Audit coupon/promotion customizations — this is the priority
  2. Plan loyalty engine data migration for active programs and coupons
  3. Review website theme compatibility with new builder
  4. Check if Knowledge app replaces any third-party wiki modules
  5. Test dark mode with custom CSS and themes
  6. Validate spreadsheet modules against custom dashboard needs

DeployMonkey Advantage

DeployMonkey deploys Odoo 16+ with the unified loyalty engine properly configured. Our AI agent can set up loyalty programs, coupons, and promotions using the new architecture.