OdooWiki OCA HUB

Contacts in several partners

partner_contact_in_several_companies folder_open OCA/partner-contact open_in_new
Customer Relationship Management License: AGPL-3

This module extends Odoo's Contacts app to allow one contact to have several job positions in different companies. It is an essential add-on for handling the 'gig economy' where people often work for several companies at a time (e.g., film and television industry, contract developers, construction, etc.)

Contacts are categorized as either:

  • Standalone Contact (default): A normal contact (either an Individual or a Company), though only Individual Standalone contacts can be linked to.
  • Attached to existing Contact: Usually used when adding a contact under a Company, this contact is linked to a source Standalone Contact. Source contacts can only be Individuals, not Companies, nor can an Attached contact serve as the source of another Attached contact.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Lets one person be linked to several companies as different job positions, while keeping a single main contact record for their personal details.

This module changes how contacts work in Odoo so that the same person can appear under more than one company. On a contact form you now choose a Contact Type: a Standalone Contact (the normal person or company record) or an Attached to existing Contact, which is a position held at a company and linked to a Main Contact.

  • Only individual standalone contacts can be used as a Main Contact; companies cannot.
  • When you attach a contact, its name and title are automatically copied from the main contact, and later changes to those fields are kept in sync.
  • The commercial entity of an attached contact follows its main contact when it has no parent company.
  • A new Other Positions tab on the contact form lists the other positions of a person, shown as cards, and is hidden for companies or for attached contacts.
  • In the Contacts list you get an All positions filter and a Person grouping, so you can search a person and see every position they hold.
  • The personal information page of an attached contact is hidden and instead points you to the main contact's form.
  • The contact cards show how many other positions a person has.

It touches the contact records (res.partner) and window actions, and adds a demo action called All Customers in All Positions.

Depends on

basecontactspartner_contact_personal_information_page
Models and fields (2)
  • res.partner · extends an existing modelcontact_id (Main Contact), contact_type, other_contact_ids (Others Positions)
  • ir.actions.act_window · extends an existing model

Text generated by AI (DeepSeek) from reading the Odoo 16.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: 4 confirmed, 5 with no information of 9 versions.

Sources · Odoo 16.0

Confirmed on 2026-11-03 in branch 16.0 of OCA/partner-contact.

terminal Installation and usage

OCA documentation · Odoo 16.0

Installation

Source · Odoo 16.0
  • Download the module from the OCA repository (ensure any dependencies are satisfied).
  • Place the module in your Odoo addons directory.
  • Restart the Odoo service.
  • In Odoo, go to Apps > Update Apps List.
  • Find and install the Partner Contact in Several Companies module.

After installation, all existing contacts will be of type Standalone (the default for the field contact_type).

Configuration

Source · Odoo 16.0

No configuration is needed: new contacts will automatically be of type Standalone.

Usage

Source · Odoo 16.0

To add a new Standalone contact, add a contact as usual, either by itself or under an existing contact's Contacts & Addresses tab (the Contact Type will be 'Standalone' by default). Any Standalone Individual contact can serve as the source for Attached contacts, whether that Standalone contact was added by itself or under an existing Company's or Individual's Contacts & Addresses tab.

To add a new Attached contact:

1. Ensure that the source Standalone contact is already created, though you can create the Standalone contact on-the-fly if needed.
2. Open the contact under which you would like to add the Attached contact (usually a Company, but it could be an Individual).
3. On the Contacts & Addresses tab, click the Add button.
4. Choose the type of contact you are adding (e.g. Contact, Delivery Address, Other
   Address, etc., though usually you will select Contact).
5. Select 'Attached to existing Contact' for the Contact Type
6. Select the source Standalone contact in the Contact drop-down list (or create a new one on-the-fly). Only contacts that are Standalone and are Individuals will appear in the list.
7. Fill in the other informational fields (e.g. Address, Email, Phone, etc.) This data will not be copied or synchronized from the source Standalone contact.
8. Click the Save & Close button (or Save & New). The Attached contact will appear in the Contacts & Addresses tab of the parent Company, and in the Other Positions tab of the source Standalone contact.
9. If you later change the Name of either a Standalone or Attached contact, the Name will be synchronized between all related contacts. However, other information (e.g., Address, Email, Phone, etc.) will not be synchronized.

Searching for Contacts:

When searching for Contacts, only the matching Standalone contacts are displayed, with the number of Attached contacts shown as '+ # other position(s)'. Open the Standalone contact and select the Other Positions tab to see the contacts that are 'Attached' to this Standalone contact.

NOTES:

1. This module merely sets up a relationship between the Standalone and Attached contacts — other than 'Name', there is no address, phone, email, etc. information synchronized or carried-over from one to the other. For example, an email address in the Standalone contact is not carried over to the Attached contact when created (and indeed they can both have different email addresses). The contact Name is however synchronized between Standalone and associated Attached contacts.
2. Attached contacts are not treated as duplicates when performing the Contact Merge action due to Attached contacts being specifically removed from the results of the res_partner.search() method (i.e. only Standalone contacts are returned during a res_partner.search()).
3. This module is compatible with the OCA's Partner Contact Access Link (partner_contact_access_link) module.
4. When you install this module, existing contacts will all become Standalone contacts. If there are any child contacts of Companies that you would like to convert to Attached to an existing contact, it is a manual process: create the new Standalone contact without any parent, and then change the child contact's Contact Type from 'Standalone' to 'Attached to existing Contact' and choose the new Standalone contact that you created without any parent.


For further information:

Please visit:

  • https://www.odoo.com/forum/help-1
  • https://github.com/OCA/partner-contact/
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.