OdooWiki OCA HUB

Field MultiSearch with separator

multisearch_field folder_open OCA/server-ux open_in_new
Uncategorised License: AGPL-3

This module allows mulit_searching for all search. For that, it add code before the search function.

It will allow you to search for multiple values separated by the character you have configured.

  • It will split the value like this:

into

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Lets users search several values at once in any Odoo search box by typing them separated by a configured character (for example |, ; or ,). Odoo then returns records matching any of those values.

This module changes how Odoo interprets what you type in search fields, across all screens that use a search box.

  • A system setting called multi_search_separator is created with the default value |; ,. This defines which characters act as separators between several search values.
  • When you type a search term that starts with / and contains one of those separators, Odoo splits the text into the individual values and searches for records matching any of them (an OR search) instead of treating the whole text as one single value.
  • The behaviour is applied at the base level of Odoo, so it works on every model and every search view, not only on one screen.
  • If no separator is configured, or the search text does not start with /, the search behaves exactly as before.

There are no new menus, buttons or reports. The change is invisible except in the search results: one search can now cover several values at once. The setting can be adjusted by administrators through the technical configuration parameters.

Depends on

base

Text generated by AI (DeepSeek) from reading the Odoo 16.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: 1 confirmed, 8 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/server-ux.

terminal Installation and usage

OCA documentation · Odoo 16.0

To configure the separator you must:

  • be in dev_mode
  • go to Settings / technical / system parameter
  • search multi_search_separator
  • add/rm the separator
  • available separators must be set like this : \|; for "|" and ";"

To use mulit_search you must put an "/" before the value you want to search. like this "/Kelly perry hart" Do not put a separator between the first value and "/".

  • Before: searching "/kelly|perry;hart" in employee, will give a none result.
  • After: Searching "/kelly|perry;hart" in employee, will give "Kelly", "Perry" and "Hart"

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.