Customizable Field Mapping
The field mappings allow you to decide what contact data should be synced.
PieSync will give you a predefined list of field mappings, the "Default Field Mapping". These are the default contact fields that correspond between the two apps of your choice.
You are also able to add your own mappings, the "Customizable Field Mapping". Both custom field mappings and default field mappings can be synced with each other.
You can set up customizable field mappings below the default field mapping in the configuration by clicking 'add field mapping'. You can add an unlimited amount of mappings and remove, enable/disable them anytime.
Below you see an example. Of course, this is dependent on the apps you have connected and which (custom) fields you have available on both sides.
Changing the Default Field Mapping
As the default field mapping is a predefined list of mappings, some of the field mappings might not suit your use case.
In that case, you are able to change the specific default field mapping by disabling it.
This will make the specific contact fields available in the customizable field mappings.
You can now match these previous default fields with other fields of your choice.
What are Custom Fields?
Custom fields are fields that are not part of the standard fields offered by the applications you are syncing. In most cases, they are added by the user.
What is a custom mapping?
Two fields* (standard or custom) kept in sync, defined by the user.
*Some standard fields are already synced in the default field mapping.
Are custom mappings always two-way?
The custom mappings will sync in the direction you have set up in the configuration of your connection, so this could be either two-way or one-way.
However, there are some exceptions where a custom mapping can only sync one-way:
- When certain contact fields are not allowed to be modified through a third-party integration such as PieSync.
- When a field only allows some specific values.
- When two mapped fields are of a different type.
IMPORTANT SIDE NOTES
Why are my (custom) fields not showing in the custom mappings dropdown OR greyed out?
Each field can only be mapped once.
Fields that are used in the built-in mappings (default field mapping), cannot be used in the custom mappings.
Fields in a custom mapping must be of the same or a similar type. You can’t sync a numeric field to a date field for example. When selecting fields in a custom mapping, the list on the other side will only show the fields that can be mapped, unavailable mappings are either not visible or greyed out.
Some types of custom fields (and app & integration dependent) are technically not mappable (drop-down, lists, multiple values)
Fields with multiple values (see example below) can’t be synced in a custom mapping. In some cases, they are synced in the default field mapping. With multiple values, we mean fields such as emails, phone numbers and addresses where each value has a label to differentiate between ‘home’, ‘work’ and ‘other’ for example.
Why can't I set up any custom mapping?
This could be caused by one of the following reasons:
- All standard fields were already mapped by default
- There are no other (custom) fields available/left to map
- There are no compatible fields left to map