Skip to main content

Fuzzy search with the PostgreSQL trigram extension

Project description

Beta License: AGPL-3 OCA/server-tools Translate me on Weblate Try me on Runbot

This addon provides the ability to create GIN or GiST indexes of char and text fields and also to use the search operator % in search domains. Currently this module doesn’t change the backend search or anything else. It provides only the possibilty to perfrom the fuzzy search for external addons.

Table of contents


  1. The PostgreSQL extension pg_trgm should be available. In debian based distribution you have to install the postgresql-contrib module.

  2. Install the pg_trgm extension to your database or give your postgresql user the SUPERUSER right (this allows the odoo module to install the extension to the database).


If the odoo module is installed:

  1. You can define GIN and GiST indexes for char and text via Settings -> Database Structure -> Trigram Index. The index name will automatically created for new entries.


  1. You can create an index for the name field of res.partner.

  2. In the search you can use:

    self.env['res.partner'].search([('name', '%', 'Jon Miller)])

  3. In this example the function will return positive result for John Miller or John Mill.

  4. You can tweak the number of strings to be returned by adjusting the set limit (default: 0.3). NB: Currently you have to set the limit by executing the following SQL statment:"SELECT set_limit(0.2);")

  5. Another interesting feature is the use of similarity(column, 'text') function in the order parameter to order by similarity. This module just contains a basic implementation which doesn’t perform validations and has to start with this function. For example you can define the function as followed:

    similarity(, 'John Mil') DESC" % self.env['res.partner']._table

For further questions read the Documentation of the pg_trgm module.

Known issues / Roadmap

  • Modify the general search parts (e.g. in tree view or many2one fields)

  • Add better order by handling

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.



  • bloopark systems GmbH & Co. KG

  • Eficent

  • Serpent CS



This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/server-tools project on GitHub.

You are welcome to contribute. To learn how please visit

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page