OdooWiki OCA HUB

Attachment Queue

attachment_queue folder_open OCA/server-tools open_in_new
Generic Modules License: AGPL-3

This module adds async processing capabilities to attachments by implementing a new model attachment.queue that wraps attachments and stores additional information so that it can be processed in an asynchronous way.

A use case of this module can be found in the attachment_synchronize module.

auto_awesome What this module does

AI-generated from the code · Odoo 18.0

Adds an attachment queue that processes files in the background, with status tracking, manual run/reschedule buttons, and failure email notifications.

This module introduces a new "Attachment Queue" screen where files are processed asynchronously instead of immediately. Each queued attachment has a status: Pending, Done, or Failed, plus a completion date and an error message field.

When a queue record is created, a background job is automatically scheduled to process it. Users can also act from the form: - "Manual run" starts processing right away (only when Pending or Failed). - "Reschedule" puts the record back to Pending and schedules a new job (only when Done or Failed). - "Set to Done" marks it as finished manually.

If processing fails, the status becomes Failed, the error is stored, and an email is sent to the addresses listed in the failure emails field using the "Attachment Failure notification" template. A wizard lets you reschedule several selected attachments at once.

The queue is available under the Queue Job menu, with list, form, and search views. Search filters include Pending, Failed, Done, My Documents, URL, and Binary, and you can group by owner, type, company, creation month, state, or file type. The model is linked to standard attachments and includes chatter and activities. Only managers (technical group) can create, edit, or delete queue records; regular users have read-only access.

Depends on

basemailqueue_job

Menus it adds

menu_attachment_queue
Models and fields (2)
  • attachment.queue · new modelstate, date_done, file_type, attachment_id, state_message, failure_emails
  • attachment.queue.reschedule · new modelattachment_ids (Attachments)

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-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 5 confirmed, 4 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.0

Go the menu Settings \> Technical \> Database Structure \> Attachments Queue

You can create / see standard attachments with additional fields

Configure the batch limit for attachments that can be sync by the cron task at a go:

Settings \> Technical \> System parameters \> attachment_queue_cron_batch_limit

This module can be used in combination with attachment_synchronize to control file processing workflow

No verified information in OCA: Installation, Configuration.

info

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.