hr_homeworking_radio_image

Work locations in Odoo HR carry a location_type selection with three values: office, home and other. This widget renders that selection as a row of icon radio buttons, an outlined building, a house and a map marker, instead of the standard labeled radios.

Under the hood it is the plain radio widget with one swap: a replacement template. The component class is empty except for the template assignment, and the descriptor spreads radioField wholesale. All the logic, items, change handling, checked state, is inherited; only the markup changed.

That replacement template is where all the behavior lives. It loops the selection items but renders a radio only for values in a hardcoded list, ['office', 'home', 'other'], and picks the icon with an if/else chain: building for office, home for home, map marker for everything else that survived the whitelist. Labels are not rendered at all; the icons are the interface.

The widget exists because of hybrid work. When Odoo added homeworking features, the work location record became something employees and HR touch often enough that a compact, icon-first picker beat a text dropdown; the same three icons reappear across the homeworking calendar and presence features, so the form teaches the vocabulary the rest of the app speaks.

For HR administrators the practical meaning is standardization: the three types are a fixed taxonomy, not a customizable list. Odoo's own UI commits to exactly office, home and other, and this widget is that commitment rendered literally, values outside the trio have no radio.

If your organization genuinely needs a fourth location type, treat this widget as a signal that you are leaving the paved road: the field accepts new selection values, but this picker will not show them, and downstream homeworking features assume the trio too.

How core applies it (work location form)

<field class="o_homework_icon_types d-flex flex-wrap" name="location_type"
       widget="hr_homeworking_radio_image" options="{'horizontal': true}"/>

The same line appears in the work location list view, making the type editable inline. The horizontal option is inert, see the note above.

What a custom value does

# adding a selection value in Python...
location_type = fields.Selection(selection_add=[("client", "Client site")])

...renders nothing in this widget: client is not in the template's whitelist, so the radio row still shows three buttons and the value can only be set from elsewhere. Use the plain radio or selection widget on views where custom values must be pickable.

The widget rewards a close read because everything interesting is a hardcode.

The whitelist beats the field definition. The template's t-if checks membership in ['office', 'home', 'other'] before rendering each item. The base radio machinery still loads every selection value into items, so the data is there; the markup just declines to draw it. Meanwhile the icon chain's else branch means other and only other gets the map marker, since anything else already failed the whitelist.

A module and a namespace disagree. The file lives in addons/hr but the template is hr_homeworking.RadioImageField. In Odoo 17 the widget shipped with the homeworking feature set; later reshuffles moved the file into hr while the template name stayed put. Grep by template name and you will look in the wrong module.

A sibling widget shares the pattern. hr_holidays ships its own hr_holidays_radio_image, the same base-radio-plus-template trick with a different template, proof that the pattern is a house style for icon radios rather than a one-off.

The 17-only preload. Odoo 17 also added a preloadedData registry entry so many2one radios would prefetch, copied from the base radio's own preload. Odoo 18 removed that registry; the entry vanished with it, harmless since the core usage is a selection anyway.

Odoo 20 is expected at Odoo Experience in Brussels, 24 to 26 September 2026, and the development branch is not final until then.

On the branch, the widget is deleted outright, along with its hr_holidays sibling, with no alias left behind. The work location form migrates to the badges_selection widget with an icon configuration: {'default_icon': 'location_on', 'icon_mapping': {'office': 'business', 'home': 'home'}}, and the list view drops the inline type column entirely. Custom views naming hr_homeworking_radio_image will log Missing widget and fall back to the default selection rendering; migrate them to badges_selection with an equivalent mapping. We re-verify at release.