Skip to main content
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 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.
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 is decided, for seeing, editing and deleting: 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 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. 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).

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).
  • 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 for the details.