See things differently? This article reflect Sharegate Desktop version 7.0 or greater. Manually update to the latest version or download the legacy Migration manual on our version page.
You can modify the source properties to map the value of that property to the defined destination properties.
- Once you have selected the action you want to perform from the Migration menu and connected to a source and a destination, select Mappings.
- Select the Properties tab.
- Search for the Properties in the source.
- Drag and drop them in the appropriate spot.
- Click Save
By default, all properties with the same name are automatically mapped together. To change a mapping or to create a new one, simply drag and drop properties from the list of source properties to the right pane. Make sure to place them next to the desired source property.
The source properties are all the values pulled from Google Drive and from the files themselves, while the destination properties are all the fields that are available in the destination library. The system properties are not displayed in the list of destination properties since they are not writable, they will automatically be handled depending on the options you choose for the copy.
Once saved, these mappings will be applied during the copy. The value in the source property will be copied to the destination property. A colored indicator will display whether a property is mapped or not. Red means it isn’t mapped while green means it is.
Note: You can’t add fields to your library from this window. It simply displays what is available in SharePoint. If you want more properties to appear in this window, you will need to add columns to your SharePoint library.
If a destination column allows for multiple values, you will be able to merge multiple columns into one during the migration. For example, two metadata values from the source file can be merged to a managed metadata column that allows multiple values in the destination library (considering the values exist in the term set used by the managed metadata column).
Key properties serve to help Sharegate determine if a list item being copied should be overwritten when an item with the same property exists in the destination, or if it should be copied as a separate item. For example, two list items can have the title "Team meeting", but they can be on different dates, and so they can be two different items (whereas for documents, two files with the same file name value in the same folder are implicitly the same file).
By default, Sharegate will always try to determine the best keys for your list. However, to make sure that items that already exist on the destination are correctly overwritten when necessary, you should define the key properties yourself. You can do so by clicking on the key icon besides the property mapping.