Learn about our newest features and enhancements!
Data Importing: How to Import Relationships
Jessica Mocha 5/29/2024 2:35:00 PM


When importing contacts, it is important to think about the relationships they have with other contacts within the database, such as spouse, parent-child, employee-employer, etc.. Creating these relationships within CharityEngine will help organize and group contacts.


  1. It is important to note that CharityEngine can support relationships vs. connections. A relationship (i.e. a Head of Household/Spouse of a Household or an employee of an organization) will roll transactions up to the Household or Organization record. A connection allows the user to see connections across people or organizational records (i.e.  a member of an organization or related person to another person). In a connection, the donations of the contact will NOT roll into the household or organization record. As a result, it is important to evaluate your organization's data to determine if the record should be considered in the roll up or simply needs a connection.
  2. Please review our article Contacts: Relationships & Connections for connections and relationship management
    1. Any custom relationships will need to be created prior to the importing process outlined below
    2. All contacts for relationship importing require that the contact record has been created
  3. Please review our article Contacts: How to Create and Manage Household Contact Records for details on managing Households including Head of Household, Spouse, and other Member connections

Preparation: Preparing to Import to the Relationships Table

Prior to importing relationship for bulk update, users will be required to complete the following steps:

  1. Capture the CharityEngine ID of the primary relationship (person, organization, or household)
  2. Capture the CharityEngine ID of the related contact (person, organization, or household)
  3. Capture the CharityEngine relationship ID
    1. Navigate to the Configuration App > Relationships > Relationship Types
    2. Captured the relationship ID for the primary relationship type by navigating to ACTIONS > Manage and capture the 1- 5 digit relationship ID
    3. Capture the relationship Type for the primary relationship (system or custom)

      1. In this example, the relationship type id = 3
      2. The relationship type = system

Instructions: How to Import to the Relationships Table

Next, prepare the import file/template.

Step 1: Navigate to the Automation & Workflow App > General > Import/Export > Create New > Import (Classic) > Import To: Relationships > NEXT

Step 2: Using the add fields, add the following fields:

  1. Primary Relationship Type Id
  2. Primary Contact Id
  3. Related Contact Id
  4. Primary Relationship Type

Step 3: Prepare the import file. Click on download import template and enter the appropriate data points for each column. One line represents on relationship.

Note: If two contacts represent a Parent/Child - only one line is needed representing the primary relationship (Parent) to the related contact (Child). It is not necessary to add a second line to represent Child to Parent.

Step 4: Save the file to a local network and close the file

Step 5: Click NEXT

Step 6: Click Upload a File

Step 7: Click Choose File and locate file for local network

Step 8: Once uploaded, click NEXT

Step 9: Name the job, set start date, adjust notifications, and other settings as needed. Click NEXT

Step 10: Review the import job and click FINISH once ready

Review and QA results.

From the Contact record, navigate to the Connections panel (or Member panel where appropriate) to verify relationships

Verdelski Green is the Parent of Aulani Piel

FAQs & Additional Reading

Q. How can I import Head of Household/Spouse to Household Records?
A. Follow our guide Data Importing: How to Import Contact - Household Data for additional importing support related to HoH/Spouse membership/connection assignment.

Q. Where can I learn more about the Relationship and Connection functionality of CharityEngine?
A. Follow our guide Contacts: Relationships & Connections for additional information on creating, managing, and reporting of relationships/connections.

Related Articles

Powered by Powered By CharityEngine