OdooWiki OCA HUB

Kanban - Stage Support

base_kanban_stage folder_open OCA/server-tools open_in_new
base License: LGPL-3

This module provides a stage model compatible with Kanban views and the standard views needed to manage these stages. It also provides the base.kanban.abstract model, which can be inherited to add support for Kanban views with stages to any other model. Lastly, it includes a base Kanban view that can be extended as needed.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Adds a reusable Kanban stage system to Odoo, letting you define stages per model and manage cards with priority, status, colour and assigned user. It is a technical foundation that other modules inherit to get Kanban boards with stages.

This module gives Odoo a generic Kanban stage engine that other modules can build on. It does not add a board to a business document by itself; instead it provides the building blocks.

  • A new "Kanban Stage" record lets you name a stage, describe it, set its order, choose whether it is collapsed in the board, and pick which model it belongs to. Each stage also carries explanation texts for priority, normal handling, ready and special handling.
  • Stages are managed from a new Kanban menu under the Customization menu, with a Stages list and form.
  • A reusable abstract model (base.kanban.abstract) can be inherited by any model to give it a stage, an assigned user, a priority (normal, medium, high), a colour index, a sequence for ordering cards, and a status (normal handling, ready, special handling).
  • The default stage is automatically picked from the stages defined for that model, and only stages linked to the same model can be selected.
  • A base Kanban view is provided, grouping cards by stage, showing the status selector, priority stars, colour picker and the assigned user's avatar.
  • On the Models screen, a new "Kanban" flag marks which models support stages; it can only be set on custom models and cannot be turned back off.

Depends on

base

Required by other modules

base_kanban_stage_state

Menus it adds

KanbanStages
Models and fields (3)
  • ir.model · extends an existing modelis_kanban (Kanban)
  • base.kanban.stage · new modelfold (Collapse?), name (Stage Name), sequence, description, legend_done (Ready Explanation), res_model_id (Associated Model), legend_normal (Normal Handling Explanation), legend_blocked (Special Handling Explanation), legend_priority (Priority Explanation)
  • base.kanban.abstract · new modeluser_id (Assigned To), stage_id (Kanban Stage), kanban_color (Kanban Color Index), kanban_status, kanban_priority, kanban_sequence, kanban_legend_done (Ready Explanation), kanban_legend_normal (Normal Handling Explanation), kanban_legend_blocked (Special Handling Explanation), kanban_legend_priority (Priority Explanation)

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 with no information of 9 versions.

Sources · Odoo 15.0

Confirmed on 2026-11-03 in branch 15.0 of OCA/server-tools.

terminal Installation and usage

OCA documentation · Odoo 19.0

Configuration

Source · Odoo 19.0

No configuration is needed or possible.

Usage

Source · Odoo 19.0
  • Inherit from base.kanban.abstract to add Kanban stage functionality to the child model:
class MyModel(models.Model):
    _name = "my.model"
    _inherit = "base.kanban.abstract"
  • Extend the provided base Kanban view (base_kanban_abstract_view_kanban) as needed by the child model while making sure to set the mode to primary so that inheritance works properly. The base view has four name attributes intended to provide convenient XPath access to different parts of the Kanban card. They are card_dropdown_menu, card_header, card_body and card_footer:
<record id="my_model_view_kanban" model="ir.ui.view">
    <field name="name">My Model - Kanban View</field>
    <field name="model">my.model</field>
    <field name="mode">primary</field>
    <field name="inherit_id" ref="base_kanban_stage.base_kanban_abstract_view_kanban"/>
    <field name="arch" type="xml">
        <xpath expr="//div[@name='card_header']">

        </xpath>
        <xpath expr="//main[@name='card_body']">

        </xpath>
    </field>
</record>
  • To manage stages, go to Settings \> Technical \> Kanban \> Stages.

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.