This module allows to define a set of products which will be added automatically to the sales order whenever that product is present on it.
auto_awesome What this module does
AI-generated from the code · Odoo 18.0Define attached products on a product so they are added automatically to sales orders when the main product is present. Attached lines follow the main line quantity and are removed when the main product is removed.
This module lets you configure, on each product form, a list of "Attached Products" that should be added automatically to a sales order whenever that product appears on it.
- On the product form (Sales tab area), a new "Attached Products" field lets you pick several products. Only products from the same company or shared products can be selected.
- When a sales order line is created or changed, Odoo automatically creates extra order lines for the attached products, flagged as attached lines and linked to the main line.
- Attached lines copy the quantity of the main line. If the main line quantity changes, the attached lines are updated and their price is recomputed.
- If the main line is removed, its attached lines are removed too. If the main product's attached product list changes, lines that no longer match can be cleaned up.
- An automatic refresh runs when relevant fields change (product, unit of measure, quantity) on order lines, and when orders or lines are created, modified or deleted. Orders in done or cancelled state are not refreshed.
- The behaviour of removing attached lines that no longer match can be controlled through a system parameter.
It touches product.template, sale.order and sale.order.line.
Depends on
Models and fields (4)
- sale.order · new model
- sale.order.line · new modelis_attached_line, attached_line_ids, attached_from_line_id
- product.template · extends an existing modelattached_product_ids (Attached Products)
- sale.attached.product.mixin · new 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: 5 confirmed, 4 with no information of 9 versions.
Sources · Odoo 13.0
Confirmed on 2026-11-03 in branch 13.0 of OCA/sale-workflow.
terminal Installation and usage
OCA documentation · Odoo 18.0Configuration
Source · Odoo 18.0To configure attached products:
- Go to Sales \> Products \> Products and choose on you want to attach products to.
- Go to the Sales tab and then to the Attached products section.
- Add as many products as you want to.
If you want to autoupdate the products when they are added, set this config parameter:
> - sale_attached_product.auto_update_attached_lines
Otherwise, the lines will be added, but they can be modified, deleted, etc.
Usage
Source · Odoo 18.0Now that you have your product configured:
- Place a new sale order and then add that product in a new line.
- Once you save your order, the attached products will be added in new lines to the order with as many quantities as the main one.
If the global sale_attached_product.auto_update_attached_lines setting is on:
- Update the main product quantity and the attached product quantities will be updated in the same amount as well.
- If we delete the main line, the attached ones will go away in any case.
No verified information in OCA: Installation.
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.