When ShareGate Desktop copies list items, there is no implicit way to know if the item that is being copied already exists in the destination of your migration, so it uses Key Properties to avoid overwriting items.
Note: Key properties can only be changed on a list. Library migrations rely on the file name which is always unique to each document.
You can set ShareGate Desktop to handle already existing content in different ways. For instance, you can copy and replace existing items at the destination, and you can copy only newer items (incremental copy).
These actions require the application to determine what items are matching between the source and the destination.
To do so, ShareGate Desktop relies on the properties Title and Created since they are default properties and usually offer a unique value on every list item.
Note: Calendar items have key properties as well, but they are different than those of list items. These properties are Created, Recurrence, Start Time, and Title.
When should you change key properties?
You will have to select new Key properties if you're dealing with one of the examples below:
- Multiple list items have the same values in the Created and Title fields (for example, some lists will not use Title, and something like a workflow operation can leave multiple items with the same Created value).
- The Key properties were set on other properties that dont have a unique value for each list item.
Note: your list item IDs cannot be used as a Key property because they are not always preserved in the destination list.
How-to change your key properties
- Click Copy.
- Click from the Copy menu and connect to a source, and a destination.
- Click from the top right corner.
- Select the Properties tab.
- Select the key icon next to the property you wish to use as a key property.
- Click Save.