v 13.0 Third Party 150
Download for v 13.0 Deploy on Odoo.sh
Odoo Online
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 935
Technical Name base_import_odoo
Versions 14.0 13.0 10.0
You bought this module and need support? Click here!

Import from Odoo

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

This module was written to import data from another Odoo database. The idea is that you define which models to import from the other database, and add eventual mappings for records you don’t want to import.

Use cases

  • merging databases
  • one way sync
  • aggregating management data from distributed systems

Table of contents


Go to Settings / Remote Odoo import / Import configurations and create a configuration.

After filling in your credentials, select models you want to import from the remote database. If you only want to import a subset of the records, add an appropriate domain.

The import will copy records of all models listed, and handle links to records of models which are not imported depending on the existing field mappings. Field mappings to local records also are a stopping condition. Without those, the import will have to create some record for all required x2x fields, which you probably don’t want.

Probably you’ll want to map records of model res.company, and at least the admin user.

The module doesn’t import one2many fields, if you want to have those, add the model the field in question points to to the list of imported models, possibly with a domain.

If you don’t fill in a remote ID, the addon will use the configured local ID for every record of the model (this way, you can for example map all users in the remote system to some import user in the current system).

For fields that have a uniqueness constraint (like res.users#login), create a field mapping if type unique, then the import will generate a unique value for this field.

For models using references with two fields (like ir.attachment), create a field mapping of type by reference and select the two fields involved. The import will transform known ids (=ids of models you import) to the respective local id, and clean out the model/id fields for unknown models/ids.

You can add custom defaults per model in case your database has different required fields than the source database. For res.partner, you’ll most certainly fill in {'name': '/'} or somethign similar.


To use this module, you need to:

  1. go to an import configuration and hit the button Run import
  2. be patient, this creates a cronjob which will start up to a minutes afterwards
  3. reload the form, as soon as the cronjob runs you’ll see a field Progress that lets you inspect what was imported already
  4. note that the cronjob also resets the password as soon as it has read it. So for a subsequent import, you’ll have to fill it in again
  5. running an import a second time won’t duplicate data, it should recognize records imported earlier and just update them

Known issues / Roadmap

  • Yes of course this duplicates a lot of connector functionality. Rewrite this with the connector framework, probably collaborate with https://github.com/OCA/connector-odoo2odoo
  • Support reference fields, while being at it refactor _run_import_map_values to call a function per field type
  • Add duplicate handling strategy ‘Overwrite older’

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 to smash it by providing a detailed and welcomed feedback.

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



  • Therp BV
  • Hunki Enterprises BV



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 https://odoo-community.org/page/Contribute.

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.
Please choose a rating from 1 to 5 for this module.