Contacts & Profile
Workflows

Roles and relationships (two-way People to Organisations)

Add, edit, end and view two‑way People‑to‑Organisations roles in SwiftFox.

August 19, 2026
ID:
291

Relationships in SwiftFox connect People to Organisations through roles. A role records how a person relates to an organisation — their title, dates and workplace details, plus any custom fields your account has configured against roles (see Custom fields on roles). Roles are two-way: create one on either record and it appears on both.

Adding a relationship

  1. Open a Person and go to the Contacts and Roles tab.
  2. Click Add relationship.
  3. Choose the Organisation to link to.
  4. Assign the Role / Title.
  5. Set the Relationship dates (start and, if applicable, end).
  6. Add the Workplace and any other role-specific contact details. If your account has custom fields configured against roles, fill those in from the role card using Edit Custom Fields (see Custom fields on roles).
  7. Save.

The relationship now appears on both the Person and the Organisation — you record it once and see it from either side.

Roles created by a custom field

A role can also be created without anyone opening this tab. A Record custom field with Sync to relationship enabled creates a role whenever a record is added to it, using the job title configured on the field.

Those roles behave like any other role here, with one important difference: the sync runs one way. Ending the role on this tab does not clear the custom field, and the field remains the source of truth. To end such a relationship properly, remove the record from the custom field. See Record custom fields (referencing people & organisations, and syncing to relationships).

Editing, ending and moving roles

Use the ⋯ menu on a role card to manage it:

  • Edit — update the title, dates, workplace or other details.
  • End role — close off the relationship (for example when a person leaves an organisation).
  • Move — move the role to a different organisation where supported.

Historic roles

When a role is ended, it moves into the Historic roles area. This preserves the full relationship history — you can always see where a person has been and when, without cluttering their current roles.

The main role

A contact's main role is what surfaces on the business card. Keeping current roles accurate ensures the business card and any role-based lists and communications reflect the contact's present situation.