many2many_tax_tags

On journal items and tax configuration lines, the tags being picked are not labels; they are tax grid tags, the markers that route amounts into the boxes of your VAT or tax return. Odoo renders them with this widget, a thin specialization of the standard tags control.

The source shows exactly how thin: the descriptor spreads many2ManyTagsField and swaps one component, the autocomplete. The replacement overrides loadOptionsSource to guarantee a Search More entry at the bottom of the dropdown regardless of how many results came back, and its onSearchMore passes the typed text into the selection dialog as a default name filter.

Everything else, the pills, the removal crosses, every option, is the tags widget you already know.

Tax tags are where bookkeeping meets the tax authority: each tag corresponds to a box on a return, and the sum of lines carrying it is what lands in that box. A mispicked tag does not look wrong in the ledger; it looks wrong in the filing, months later, in front of an auditor.

That is the business case for the widget's one behavioral change. Localizations ship dozens of near-identical grid names, and the always-available Search More opens the full list view, searchable and sortable, instead of trusting a truncated dropdown. Slower by a click, safer by a lot, the right trade for fiscal data.

The deeper safeguard is configuration, not widgetry: when taxes are set up correctly, their repartition lines apply grid tags automatically and humans rarely touch this field on documents. Frequent manual tag editing on journal items is a signal your tax configuration needs attention, not your users.

How journal item views use it

<field name="tax_tag_ids" widget="many2many_tax_tags"/>

Locked down on document lines

<field name="tax_tag_ids"
       widget="many2many_tax_tags"
       options="{'no_create': True}"/>

Grid tags come from the localization; users should pick, never invent. The inherited option closes creation exactly as on the base widget.

Delaying search on huge localizations

<field name="tax_tag_ids"
       widget="many2many_tax_tags"
       options="{'search_threshold': 2, 'no_create': True}"/>

Two source details close the loop on how this widget behaves in the wild.

Search More is appended, not configured. The overridden loadOptionsSource checks whether the last dropdown entry is already the Search More row and adds it if not. The dialog it opens is the standard select-create list, seeded with your typed text via search_default_name, so "intra" typed in the line becomes the search term in the dialog. Small touch, big difference on 60-grid localizations.

The autosave sibling. The same folder registers autosave_many2many_tax_tags, extending this widget for places that must persist the change immediately rather than with the document save. Same look, different commit timing; its own page covers it.

Odoo 20 is expected at Odoo Experience in Brussels, 24 to 26 September 2026. The changes below are read from the public development branch and are not final until release.

This widget's own file is unchanged: same spread of the base descriptor, same autocomplete override, same registration. What changes underneath is the base tags widget itself, which gains tag_limit and on_tag_click and loses the form color-editable variant in the development branch; those changes flow into this widget automatically through the spread. Details on the many2many_tags page. We re-verify once Odoo 20 ships.