Odoo Help


Full list of search operators

on 3/17/14, 8:02 AM 11,673 views

According to the "Developer Book >> API" the search command is called like this :

 search([('arg1','=','value1')...], offset=0, limit=1000)

Where the second element in the tuple (arg1, arg2, .. ,argN: list of tuples specifying search criteria) is a . . .

search term operator ex: ilike, =, !=

Where can one find the definitive list of those search term operators ?


Ray Carnes

--Ray Carnes--
| 9 7 9
Keyport, United States
--Ray Carnes--

Senior ERP Analyst

OpenERP 6.1, 7.0; Odoo 8.0, 9.0, 10.0 and 11.0.

Completed Odoo Functional and Technical Training.

Functional Areas:

  • CRM/Sales

  • Inventory

  • Manufacturing

  • Accounting

  • Purchasing

Major Skills:

  • Business Process Reengineering

  • Efficiency Consulting

  • User Needs and GAP Analysis;

  • Functional and Technical Design;

  • Prototyping and Proof of Concepts;

  • Requirements Specifications;

  • Agile Implementation;

  • Data Migration;

  • Configuration & Customization (UI and code);

  • Integration - Odoo and non Odoo Applications and Services;

  • Training and Knowledge Transfer;

  • Go Live Support;

  • Helpdesk;

  • Version Upgrades and Migration.

  • Accounting Expert.

I have over 20 years of experience empowering and enabling users with enterprise information systems that make a real and measurable difference in their ability to proactively manage their businesses and organizations. 

I am a skilled Communicator and I only take the serious things seriously!

Ray Carnes
On 3/18/14, 12:54 AM

A definitive list of search term operators can, in fact, be found in the source code (here) can't they?

Each tuple in the search domain needs to have 3 elements, in the form: ('field_name', 'operator', value), where:

  • field_name must be a valid name of field of the object model, possibly following many-to-one relationships using dot-notation, e.g 'street' or 'partner_id.country' are valid values.
  • operator must be a string with a valid comparison operator from this list: =, !=, >, >=, <, <=, like, ilike, in, not in, child_of, parent_left, parent_right The semantics of most of these operators are obvious. The child_of operator will look for records who are children or grand-children of a given record, according to the semantics of this model (i.e following the relationship field named by self._parent_name, by default parent_id.
  • value must be a valid value to compare with the values of field_name, depending on its type.

Domain criteria can be combined using 3 logical operators than can be added between tuples:

  • '&' (logical AND, default)
  • '|' (logical OR)
  • '!' (logical NOT)

These are prefix operators and the arity of the '&' and '|' operator is 2, while the arity of the '!' is just 1. Be very careful about this when you combine them the first time.

Here is an example of searching for Partners named ABC from Belgium and Germany whose language is not english ::


The '&' is omitted as it is the default, and of course we could have used '!=' for the language, but what this domain really represents is::

[(name is 'ABC' AND (language is NOT english) AND (country is Belgium OR Germany))]

Thanks Ray. I asked where to find the list; I should really have asked where to find the full documentation, because not all the operators, or their effects, are obvious as you state. What, for example, is the difference between "like" and "ilike" ? Another: I got an error trying to use "ilike" on a record id, but the query worked when I used "=". I'm using XMLRPC where tracking down failures like the latter is really time consuming. Has no reference documentation, with example usage of each operator, been published anywhere?

on 3/18/14, 6:44 AM

About This Community

This platform is for beginners and experts willing to share their Odoo knowledge. It's not a forum to discuss ideas, but a knowledge base of questions and their answers.


Odoo Training Center

Access to our E-learning platform and experience all Odoo Apps through learning videos, exercises and Quizz.

Test it now

Question tools

0 follower(s)


Asked: 3/17/14, 8:02 AM
Seen: 11673 times
Last updated: 6/6/17, 2:19 PM