User Guide

Uplift is an automated migration analysis tool for Odoo custom modules. When you need to upgrade your Odoo instance from one version to another (e.g., 16.0 to 18.0), your custom modules often contain code patterns, API calls, and XML structures that have changed or been removed in the newer version.

Uplift scans your module's Python, XML, JavaScript, SCSS, and CSV files against a comprehensive database of 239+ migration rules and identifies every breaking change, deprecation, and required update. For many issues, it can also automatically generate the correct fix and apply it to your code.

Key benefits:

• Detect breaking changes before they cause production issues
• Get detailed explanations of what changed and why
• Auto-fix common migration patterns with one click
• Support for multi-hop migrations (e.g., 14.0 → 19.0)
• Export detailed CSV reports for project planning

Using Uplift is straightforward and requires no installation. Here's the basic workflow:

Account requirement: Viewing analysis reports is free and doesn't require an account. To apply auto-fixes and download the patched module, you'll need to create a free account and purchase a fix package.

On the home page, you'll find the upload area. You can either drag and drop your module or click to browse your files.

Requirements:

• Format: Your module must be compressed as a .zip file
• Structure: The zip should contain your module directory with a __manifest__.py or __openerp__.py file
• Size: Maximum file size is 50 MB
• Content: Only one module per upload is supported

After uploading, you'll select the source version (the Odoo version your module currently runs on) and the target version (the Odoo version you want to migrate to).

Supported versions: 14.0, 15.0, 16.0, 17.0, 18.0, and 19.0

Multi-hop migrations: You can migrate across multiple versions at once. For example, if your module is on 14.0 and you want to go to 18.0, Uplift will analyze all intermediate version changes (14→15, 15→16, 16→17, 17→18) and combine them into a single comprehensive report.

The source version must be lower than the target version.

Once the analysis completes, you'll see a detailed report with all detected issues. The report includes:

Summary Bar

At the top, you'll see your module name, migration path, total issue count, and an effort estimate (Simple, Medium, or Complex) to help you plan the migration.

Statistics Cards

Four cards show a breakdown: Errors (critical issues that must be fixed), Warnings (recommended changes), Info (optional improvements), and Auto-fixable (issues Uplift can fix automatically).

View Modes

You can view issues in three ways:

• All Issues — A flat list of every detected issue
• By File — Issues grouped by source file, useful for fixing file by file
• By Category — Issues grouped by type (ORM, Views, Fields, etc.)

Filters & Search

Use the filter bar to narrow down issues by severity (error/warning/info), category, or auto-fixable status. The search box lets you find issues by file path or message text.

Issue Cards

Each issue card shows:

• Severity badge — Color-coded: red (error), amber (warning), blue (info)
• File path and line number — Exact location in your code
• Description — What the issue is and why it matters
• Code diff — Click to expand and see the old code vs. suggested fix
• Docs badge — Links to official Odoo documentation when available
• Migration guide — Step-by-step instructions from our knowledge base

Export CSV

Click the "Export CSV" button in the top bar to download all filtered issues as a CSV file for use in spreadsheets or project management tools.

Issues marked as "Auto-fixable" can be automatically patched by Uplift. Here's how:

1. Select issues: All auto-fixable issues are selected by default. You can uncheck any issues you prefer to fix manually.
2. Sign in: You need a free account to apply fixes. Click "Sign In" or "Create Free Account" if prompted.
3. Purchase: Click "Apply Selected Fixes & Download" at the bottom of the page. You'll be shown the pricing tier based on your module's complexity, then complete payment via PayPal.
4. Download: After payment, the patched module is automatically prepared and downloaded as a .zip file.

Analysis reports are always free. You can upload and analyze as many modules as you want at no cost. You only pay when you want to apply auto-fixes and download the patched module.

Pricing is based on the complexity of your module (measured by the number of auto-fixable issues):

The correct tier is automatically selected based on your analysis results. Payment is processed securely via PayPal — no PayPal account is required, you can pay with any credit or debit card.

After signing in, you can access your dashboard from the navigation bar. The dashboard provides an overview of all your activity:

Statistics

At the top, you'll see summary cards showing your total reports, errors found, warnings, fixes downloaded, and total amount spent.

Reports Tab

• Search: Filter reports by module name or version
• Filter: View All, Paid, Unpaid, or Downloaded reports
• Select & Bulk Actions: Use checkboxes to select multiple reports, then delete or export them in bulk
• Export: Export selected (or all) reports as a CSV summary file
• View: Click "View" to open the full analysis report
• Expand: Click any row to see detailed breakdown (errors, warnings, effort, payment info)
• Delete: Remove individual reports or use bulk delete for multiple reports

Payments Tab

View your complete payment history including date, type, status, and amount for each transaction.

Uplift analyzes your module using six specialized analyzers across eight issue categories: