---
title: How to link property pairs?
description: To synchronize data between systems, ChurchTools needs to know which data items belong together. For each connection, you map the data properties of both systems to one another, creating property pairs that you can then synchronize using jobs. The following…
url: "https://staging.churchtools.academy/en/help/churchtools-modules/configure-connections/how-to-link-property-pairs/"
updated: "2026-06-26"
category: Sync / Configure Connections
---

# How to link property pairs?

To synchronize data between systems, ChurchTools needs to know which data items belong together. For each connection, you map the data properties of both systems to one another, creating property pairs that you can then synchronize using jobs.

The following applies:

- The paired properties (also known as property pairs) apply to **all orders** **of a** connection.
- If a property in your ChurchTools system has **multiple values**—for example, gender: male or female—then these values must be uniquely linked to the values of the corresponding property in your external system: male <-> m, female <-> w, and so on.
- If not all values of a property are linked, the execution of all sync jobs for which that property is selected will be prevented. To prevent this, you can [define a **fallback behavior** for the affected values](https://staging.churchtools.academy/en/help/churchtools-modules/configure-connections/how-do-i-define-a-fallback-behavior/).

## 1. Select a connection and open the property pairs

Open a connection and select the *property pairs* for the relevant data from the menu column on the left.

**Note**

The following screenshots are taken from property pairs for personal data. The same applies to the properties of all other data to be synchronized.

[![Screenshot Sync Connection Properties pairs](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs.png)](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs.png)

## 2. Assign Properties

You can either manually assign all properties to each other in the list, or you can select " *Apply All*," which is, of course, much faster.

**Important**

Any changes you make here will always apply to **all orders** **for a** connection.

[![Screenshot Sync Connection Properties pairs list](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs-list.png)](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs-list.png)

## 3. Assign Values

Next, go through the properties one by one and assign values where necessary. You can also save a lot of time here by *using the " Apply All* " function.

[![Screenshot Sync Connection Properties pairs Gender Map values](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs_Gender_Map-values.png)](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs_Gender_Map-values.png)

## 4. Check status

The status bar above the properties always shows you whether all properties/values have been assigned—and are therefore linked—or if you still need to do something.

[![Screenshot Sync Connection Properties pairs Not completely linked](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs_Not-completely-linked.png)](https://staging.churchtools.academy/wp-content/uploads/2026/06/Sync_Connection_Properties-pairs_Not-completely-linked.png)

## Read more

- [How to add an order to a connection?](https://staging.churchtools.academy/en/help/churchtools-modules/configure-jobs/how-to-add-an-order-to-a-connection/)
- [How to configure a job?](https://staging.churchtools.academy/en/help/churchtools-modules/configure-jobs/10-configure-connection/)
- [How to define a fallback behavior?](https://staging.churchtools.academy/en/help/churchtools-modules/configure-connections/how-do-i-define-a-fallback-behavior/)
- [What is the difference between simulation and execution?](https://staging.churchtools.academy/en/help/churchtools-modules/configure-jobs/what-is-the-difference-between-simulation-and-execution/)