How to Create an Odoo Module

What is an Odoo Module?

An Odoo module is a self-contained package of code that extends Odoo's functionality. Think of it as a plugin: you can activate it, customize it, or remove it without affecting the rest of your system.

Every Odoo feature—CRM, accounting, sales—is built as a module. Custom modules follow the same architecture, which means your code integrates seamlessly.

Module Structure

A basic module contains:

• manifest.py — metadata (name, version, dependencies)
• models/ — your data structures (Python classes)
• views/ — forms, lists, search filters (XML)
• security/ — access rights and record rules
• static/ — CSS, JavaScript (if needed)
• reports/ — PDF or dynamic business reports (optional)
• wizards/ — temporary UI flows (optional)

Odoo's official tutorial, Server Framework 101, walks you through each piece with a real example: building a "Real Estate Advertisement" module from zero to deployed.

When to Build vs. Use Odoo Studio

Odoo Studio (the low-code drag-and-drop tool) handles most 80% of customizations: add fields, change layouts, simple automations.

Build a custom module when you need:

• Complex business logic (calculations, workflows, integrations)
• Reusable code across multiple Odoo instances
• Custom reports or external API calls
• Performance-critical operations
• Integration with third-party systems (webhooks, APIs)

If it's a one-off layout tweak, Studio is faster. If it's a capability your business needs, code a module once and reuse it forever.