This module extends the standard CSV import functionality to import files in the background using the OCA/queue framework.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Adds an "Import in the background" checkbox to the standard CSV import screen, so large files are split into chunks and processed by the queue instead of blocking the user.
When you import a CSV file in Odoo, this module adds a new checkbox labelled "Import in the background" on the import side panel. If you tick it and start the import, Odoo no longer waits for the whole file to be processed: it saves the data as an attachment and creates background jobs instead.
The file is automatically split into smaller chunks (100 lines by default) on record boundaries, and each chunk becomes a separate job in the queue. Each job imports its own part of the file, and if a chunk fails, the error is reported on the job. Job descriptions show the model, the file name, the chunk number and the line range, so you can follow progress. The attachment is linked to the job, and a related action button opens it directly from the job form.
A warning message tells you that your request is being processed and that you can follow it in the "Queue / Jobs" menu. The module works on the base_import.import model and extends queue.job. If you do not tick the checkbox, or if you run a test import, the standard immediate import is used.
Depends on
Required by other modules
Models and fields (1)
- base_import.import · extends an existing model
Text generated by AI (DeepSeek) from reading the Odoo 18.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-03Confirmation status: 6 confirmed, 3 with no information of 9 versions.
Sources · Odoo 16.0
Confirmed on 2026-11-03 in branch 16.0 of OCA/queue.
terminal Installation and usage
OCA documentation · Odoo 18.0Usage
Source · Odoo 18.0The user is presented with a new checkbox in the import screen. When selected, the import is delayed in a background job.
This job in turn splits the CSV file in chunks of minimum 100 lines (or more to align with record boundaries). Each chunk is then imported in a separate background job.
When an import fails, the job is marked as such and the user can read the error in the job status. The CSV chunk being imported is stored as an attachment to the job, making it easy to download it, fix it and run a new import, possibly in synchronous mode since the chunks are small.
Any file that can be imported by the standard import mechanism can also be imported in the background.
This module's scope is limited to making standard imports asynchronous. It does not attempt to transform the data nor automate ETL flows.
Other modules may benefit from this infrastructure in the following way (as illustrated in the test suite):
- create an instance of base_import.import and populate its fields (res_model, file, file_name),
- invoke the do method with appropriate options (header, encoding, separator, quoting, use_queue, chunk_size).
No verified information in OCA: Installation, Configuration.
Installation instructions, the distribution package, dependencies and configuration steps are not shown because they have not yet been verified in the module documentation for any version.
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.