Abstract module for importing emails attachments.
Each email's attachment matching a given "Attachment Condition" will be imported creating a new attachment.queue object. These attachment.queue objects are files wrapped with additional fields (mainly a Filed Type and a State) making them ready to be processed by a custom module as you can read in the attachment_queue documentation.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Automatically turn email attachments received by an incoming mail server into Attachment Queue files, based on rules you define (sender, recipient, subject, file extension).
This module connects incoming email servers to the Attachment Queue system. On each incoming mail server you can now define one or more "Attachment Conditions". Each condition lets you filter emails by sender, recipient, subject and file extension, and choose a file type that will be given to the imported files.
When an email arrives on that server, every attachment matching a condition is imported into Odoo as an attachment.queue record, with state "pending", the chosen file type, the company and a link back to the condition and the email server. If several conditions match, several files can be created from the same email.
Where it appears: - On the incoming mail server form, a new "Attachment Conditions" section lists the conditions for that server. - A dedicated screen lets you create and edit conditions, with fields for sender, recipient, subject, file extension, file type and company.
Automatic behaviour: as soon as you add a condition on a server, the server is automatically set to create attachment.queue records and to keep attachments, so the import works without extra configuration. Only system administrators can create or change conditions; other users can only read them.
Depends on
Models and fields (3)
- attachment.queue · extends an existing modelfetchmail_server_id (Email Server), fetchmail_attachment_condition_id (FetchMail condition)
- fetchmail.server · extends an existing modelattachment_condition_ids (Attachment Condition)
- fetchmail.attachment.condition · new modelname (Condition Name), email_to, file_type, server_id (Server Mail), company_id (Company), email_from, email_subject, file_extension
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: 1 confirmed, 8 with no information of 9 versions.
Sources · Odoo 18.0
Confirmed on 2026-11-03 in branch 18.0 of OCA/server-tools.
terminal Installation and usage
OCA documentation · Odoo 18.0Usage
Source · Odoo 18.0Adding an "Attachment Condition" to your Incoming Mail Server configuration will lead to the creation of attachment.queue objects from emails attachments coming from this server and matching the given Attachment Condition.
> 🔎 Recalling that, as the Incoming Mail Servers has only one > "Create a New Record" field, the emails coming from that server > cannot be used to create other type of objects than > attachment.queue.
Filling the condition's File Type field will spread this value to the newly created attchment.queue objects so they can be processed by a custom module following this File Type field value.
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.