ContactRoll
Menu
Start free, no cardStart free

Help · Sales

Relate your records to each other

A relationship says how two kinds of record are connected: a project's contacts, a company's partners, an employee's manager. Each record's page then lists its related records, and each link can carry details of its own, such as a contact's role on a project.

Relationships come with the Plus plan. Parent and child companies work on every plan.

Make a relationship

Go to Settings, Data model, Relationships, at https://app.contactroll.com/settings/data-model/relationships. The Owner and Administrators make and change relationships. So does a role of your own given "change the kinds of record".

  1. Press Add a relationship.
  2. Choose the two kinds it joins: contacts, companies, deals, cases, or a kind of record of your own. A kind can be related to itself, for example contacts to contacts for a manager.
  3. Name it from each side. A project's "Contacts" are a contact's "Projects".
  4. Choose how many:
  • Many to many: any record on either side can have any number of the other.
  • One to many: each record on the second side has at most one on the first. An employee has one manager.
  1. Choose what deleting a record on the first side does (see below).
  2. Add what each link carries, if anything: text, a number, a date, or a choice from a list.

Two kinds can have several relationships, each with its own name. A relationship that joins the same kind to itself never makes a loop. A manager can't report to somebody they manage.

A relationship that holds links can't be deleted. Archive it instead: every link stays and is shown, and no new links can be made.

Relate two records

On a record's page, find the Related card and press + Relate. Choose the relationship, type two letters or more of the other record's name, choose it, fill in what the link carries, and press Relate. Edit and Remove change or remove a link.

Relating, editing and removing a link need permission to change the record on the first side. You see a link only when you can see both of its records.

A deal's contacts, each with their role, are one of these relationships, built in. They are still changed on the deal's own Contacts card.

What deleting does

Each relationship says what happens when a record on its first side is deleted:

  • Clear its links (the default): the record goes to Trash and its links go with it. If it's restored, its links come back. When Trash's 30 days end, the links are gone and the related records stay.
  • Don't allow it while it has links: the record can't go to Trash while it is related to a record that isn't in Trash. Remove the links first, or change the rule.
  • Move the linked records to Trash with it: the related records go to Trash too, and come back when the record is restored.

Deleting a record on the second side always clears its links.

Parent and child companies

On a company's page, the Company group card shows its parent company, its child companies, and totals over the company and every company below it: open deals and deals won, in each currency, and open cases. The totals count only what you can see, and the card says how many companies it counted.

To set a parent, press + Parent company, type two letters or more of its name, and choose it. A group goes at most ten levels deep, and a company can't be below itself.

When two records are merged

When two contacts, two companies or two records of your own are merged, their relationships move to the one that stays. A link both had to the same record is kept once, and a link between the two goes. A merged company's child companies become the one that stays.

Through the API

GET /relationships lists your relationships. /relationships/{id}/links lists, makes, changes and removes links. The API comes with the Plus plan; the reference is at https://contactroll.com/developers/.

Didn’t find what you needed? Ask us on the help center: the form is at the foot of its page, and the people who build ContactRoll answer.

Ask us a question

Start free

Start free, no card

Every new organization starts with a 14-day trial of Plus, with no card. When it ends, a team of 3 people or fewer moves to Free by itself, and a larger team chooses Standard or Plus. There is no second trial.

Start free, no card

A question first? Email us at

hello@contactroll.com

The people who build ContactRoll answer it. We use your message only to answer you, and we do not add you to any list.