> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useorbitcrm.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Multiple Owners

> Give a contact, company or deal a primary owner and up to 9 co-owners who see it and work it too.

Every contact, company and deal has one owner. Turn on **Multiple owners** and a record can also have up to 9 **co-owners**: the account executive and the solutions engineer on a deal, the account manager and the customer success manager on a company.

The first owner is the **primary owner**. Co-owners count as owners for who can see and edit the record, for the **Owners** filter and for notifications, and a deal's [commission](#commission-on-co-owned-deals) can be split between its owners. Reports, goals, forecasts and the owner rules stay with the primary owner.

## Turn it on

Go to **Settings → Contacts**, **Companies** or **Deals** and turn on **Multiple owners**. Each object has its own switch, so deals can have co-owners while contacts keep one owner. Only admins can change it.

While the switch is off, nothing changes: records have one owner, and lists, filters and record pages look as they always have.

> [!WARNING]
>
> Turning **Multiple owners** off removes every co-owner of that object across the workspace. Primary owners stay. Orbit asks first and tells you how many records have co-owners. Turning it back on does not bring them back.

## Primary owner and co-owners

* A record has one primary owner and up to 9 co-owners.
* The primary owner is never also a co-owner.
* A record with co-owners always has a primary owner. If the primary owner is cleared, the first co-owner becomes the primary owner.
* Co-owners are members of the workspace. Someone removed from the workspace is taken off every record they co-owned.
* People limited to their teams' people (**People: Their teams** in their record access) can only add the people they can see.

## Add co-owners to a record

On a record page, the owner shows the primary owner's picture with the co-owners stacked beside it. Click it to open the owners picker:

* Tick a person to add them as a co-owner. Untick them to remove them.
* The primary owner has a **Primary** badge.
* Point at another owner and click **Make primary** to make them the primary owner. The previous primary owner stays on the record as a co-owner.

When you create a deal, the **Co-owners** field sits under **Owner**. It is optional.

Being added as a co-owner sends the same "assigned to you" notification as becoming the owner. The record's history shows every co-owner change.

## Lists, filters and bulk actions

While **Multiple owners** is on:

* The **Owner** column shows the primary owner, then "+2" for two co-owners.
* The **Owner** filter becomes **Primary owner**: records a person is the primary owner of.
* A new **Owners** filter matches records where the person is any owner, primary or co-owner.

Use **Owners** for a rep's "everything I work on" view, and **Primary owner** for "everything I'm accountable for".

To change many records at once, select them and use **Add co-owner** or **Remove co-owner** in the bulk actions bar. Adding someone who is already the primary owner changes nothing.

## What co-owners can see

A co-owner counts as an owner wherever [record access](https://docs.useorbitcrm.ai/guides/teams-and-routing.md#limit-people-to-their-team) is decided, for seeing, editing and deleting:

| Record access | They see |
| - | - |
| **Everything** | Every record in the workspace. |
| **Their team's** | Records on a team they belong to, plus records they own or co-own and records owned or co-owned by people who report to them. |
| **Only theirs** | Records they own or co-own, and records owned or co-owned by people who report to them. |

**Also show records with no owner and no team** still means no owner at all. A record with co-owners always has a primary owner, so it is never one of these.

## Commission on co-owned deals

With [commissions](https://docs.useorbitcrm.ai/guides/commissions.md) on, a deal's primary owner earns its commission by default. On the deal's **Commission** card, the primary owner or someone with **Manage commissions** can split it evenly or by custom percentages between the deal's owners. People with **Manage commissions** can also give an owner a custom commission instead of what their plan pays. A workspace setting can make deals with co-owners split evenly by default. See [the Commission card](https://docs.useorbitcrm.ai/guides/commissions.md#on-the-deal-page).

A commission plan can also credit every owner in full, or have the owners share each deal, whatever the deal's split says ([who gets credit for a deal](https://docs.useorbitcrm.ai/guides/commissions.md#who-gets-credit-for-a-deal)).

## What stays with the primary owner

Some things need exactly one person per record. They follow the primary owner and ignore co-owners:

* **Reports, goals, forecasts and leaderboards.** A deal counts once, for its primary owner. To share a deal's credit in reports and goals, turn on **Deal splits** in **Settings → Deals**.
* **Round robin.** An **Assign to team** step sets the primary owner.
* **Owner rules** in **Settings → Contacts** and **Settings → Deals**: **Give the company the contact's owner** and **Open deals follow the contact's new owner**.
* **Who owns the contact after a booking** ([the booking rule](https://docs.useorbitcrm.ai/guides/teams-and-routing.md#who-owns-the-contact-after-a-booking)).
* **Tasks** created for a record go to its primary owner by default.
* **Prospecting**: your queue lists the contacts you are the primary owner of.

## Merging records

When two records are merged, the record you keep has both records' owners. Its primary owner stays primary, and the other record's primary owner becomes a co-owner, up to the 9 co-owners a record can have.

## Imports and exports

* **Imports:** map a **Co-owners** column. List each co-owner's email or name, separated by `;` (`alice@acme.com; Ben Ortiz`).
* **Exports:** a **Co-owners** column lists the co-owners' emails.

## Workflows

* The **Add co-owner** and **Remove co-owner** steps add or remove a person on the record the workflow runs for.
* Record triggers carry `co_owner_ids`, so a **Filter** or **Router** can check who the co-owners are.

## With the API and MCP

Contacts, companies and deals have a `co_owner_ids` field: a list of user ids, beside `owner_user_id` for the primary owner.

* **Read** it on get and list.
* **Set** it on create and update. `co_owner_ids` replaces the whole list; `add_co_owner_ids` and `remove_co_owner_ids` change only the people you name.
* **Filter** a list with `owner_user_id` and `any_owner=true` to get the records where that person is any owner. Without `any_owner`, `owner_user_id` matches the primary owner, as before.
* **Webhooks** for contacts, companies and deals include `co_owner_ids`, and a change to it shows in `changes`.
* **MCP:** the same fields on the create, update, get and list tools for contacts, companies and deals (`create_deal`, `update_deal`, `list_deals` and the rest).
* **Turn it on:** `multiple_owners` on the contact, company and deal settings (`update_crm_settings`), for admins.

Writing co-owners while the object's **Multiple owners** setting is off is refused. See the [CRM API reference](https://docs.useorbitcrm.ai/developers/api/crm.md) for the details.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.