kanban_activity
The little clock on every kanban card is kanban_activity: a 32-line widget that quietly fetches six extra fields and color-codes your follow-ups.
| Technical name | kanban_activity |
|---|---|
| Field types | one2many (activity_ids) |
| Views | kanban |
| Module | mail, installed with Discuss in every practical database |
| Used in core | 23 occurrences across 17 modules, including fleet, account, stock, crm, project, maintenance |
| Versions | Odoo 20.0, Odoo 19.0, Odoo 18.0, Odoo 17.0, Odoo 16.0 |
| No-code setup | No. Kanban card templates are edited in view XML; the activity system itself is no-code |
| Alternatives | list_activity, activity_exception, kanban_color_picker |
What the activity clock does
What this means for your team
Supported options in Odoo 19
| Option | Type | What it does |
|---|---|---|
(none) | n/a | The widget declares no supportedOptions and reads none. Its interface is the six fieldDependencies it fetches automatically: activity_exception_decoration, activity_exception_icon, activity_state, activity_summary, activity_type_icon, activity_type_id. |
The six auto-fetched fields: activity_exception_decoration, activity_exception_icon, activity_state, activity_summary, activity_type_icon and activity_type_id. All come free with the activity mixin. A curiosity for source readers: the selection values in that declaration are written as Python-style tuples inside JavaScript, which collapse to plain strings at runtime, harmless, since only the field names matter for fetching, but a reminder that this file was translated from Python conventions.
Working examples
Inside ActivityButton: icon priority, colors, and the selection trick
Version compatibility
| Version | Status | Notes |
|---|---|---|
| Odoo 20.0 | In development | Not released. The development branch shows no functional changes; internals only. See below. |
| Odoo 19.0 | Verified | Verified against the shipped source, widget and shared ActivityButton. |
| Odoo 18.0 | Verified | Identical dependencies and registration, verified in the 18.0 source. |
| Odoo 17.0 | Verified | Widget present with the same registry name. Not re-verified line by line for this page. |
| Odoo 16.0 | Verified | Widget present with the same registry name. Not re-verified line by line for this page. |
Upgrade note. Nothing to migrate: no options in any version, and the 18 and 19 declarations are identical, verified. Custom kanban templates written for 16 or 17 keep working; only deep JavaScript patches against the mail components need re-testing per release, standard practice during an Odoo migration.
What is changing in Odoo 20
Common problems and fixes
| Symptom | Cause and fix |
|---|---|
| No clock icon on the cards | The widget is missing from the card template, or the model lacks the activity mixin. Add the field with the widget to the kanban template and confirm the model inherits mail.activity.mixin. |
| Clock stays gray despite scheduled activities | Activities exist but belong to other records, or the state fields were shadowed by a custom view fetching them differently. Check the record's own activities; the six dependency fields are fetched automatically. |
| A warning triangle replaced the clock | An activity exception is set on the record; the exception icon and color override everything. Open the record and resolve the flagged problem; the clock returns when the exception clears. |
| Icon is a phone or envelope instead of a clock | Expected: with activities present, the next activity type's configured icon is shown. No fix needed; edit the activity type's icon if you want something else. |
| Scheduling from the popover affected several records | In list views the button applies to the whole selection when the current record is part of it. Expected power feature; clear the selection for single-record scheduling. |
| Overdue shows for an activity due today | State is computed timezone-aware per user; the user's timezone shifts the boundary. Check the user's timezone setting on their profile. |
Activity clock vs the alternatives
| Widget | Best for | Key difference |
|---|---|---|
kanban_activity | The full activity workflow on kanban cards | Clock icon plus scheduling popover, fed by six auto-fetched fields |
list_activity | Activities in list views | Adds the next activity's summary text beside the icon |
activity_exception | Showing only failure flags | Renders just the exception marker, no popover or scheduling |
| kanban_color_picker | Manual visual triage of cards | User-picked colors rather than deadline-driven state |
Frequently asked questions
What is the kanban_activity widget in Odoo?+
What do the activity clock colors mean?+
Why do I not need to add the activity fields to my view?+
What replaces the clock when something goes wrong?+
Can I use kanban_activity on any model?+
Does the widget have any options?+
Will kanban_activity change in Odoo 20?+
Boards where nothing falls through?
Activity plans per team, exception flags from your automations, and kanban cards that surface trouble by themselves: the activity system rewards proper setup. We design follow-up workflows in Odoo CRM, projects and operations for 16 through 19.
Book a free consultation