Widget category
Odoo Relational widgets
Relational widgets render links between records — many2one, one2many and many2many fields — as dropdowns, tag clouds, checkbox grids, reference pickers and editable sub-lists.
Choosing between them decides how users create and navigate related records, which makes this small category the one that shapes data quality most.
7 widgets documented54 uses in Odoo coreVersions 16.0 → 20.0 verified per widget
Every relational widget, by use in Odoo core
| Widget | What it does | Field types | Uses in core |
|---|---|---|---|
| badges_many2one | New capability in Odoo 20, not a rename. It turns a many2one into a row of clickable badges, can put a different icon on each one, and keeps working when the connection drops. | many2one | 32 |
| many2many_tags_color_dot | New in Odoo 20. It renders tags as a colored dot next to a plain label rather than a filled pill, and it overrides the parent widget's click behavior through an option nobody declares. | many2many | 11 |
| many2one_avatar_resource | This widget renders a link to a resource.resource with an avatar, distinguishing a person from a machine. It also reads an option Odoo never declares, and its click behavior changes depending on the view you put it in. | many2one | 5 |
| many2many_avatar_resource | The x2many companion to the resource avatar widget. It marks machines with a wrench, shows a hover card only for people, and in kanban it renders the tags in reverse order. | many2many | 3 |
| many2one_reference_integer | Where many2one_reference resolves a reference into a record picker, many2one_reference_integer does the opposite: it shows you the bare database id and nothing else. | many2one_reference | 2 |
| many2one_reference | The many2one_reference widget renders a reference field, where the target model lives in a second field, as an ordinary many2one picker. Leave that second field out of the view and it does not degrade: it throws. | many2one_reference | 1 |
| section_and_note_one2many | This is the widget behind order and invoice lines, the one that lets a line be a section or a note instead of a product. It reads four settings that appear in no option list. | one2many | — |
Each widget page has the usage XML, Studio steps, every developer option, and a per-version compatibility table verified against the shipped Odoo source.
Other widget categories
Need these working in your Odoo?
The team that documented every widget also builds with them — custom views, upgrades and performance work by senior Odoo developers.