Configure field mapping

Field mapping is used by editing tools and commands to copy attribute values from features on a source layer to features on a target layer. Field settings are configured on the Editor Settings dialog box on the Field Mapping side tab.

Tools that reference these field settings include Transfer Attributes , Copy Parallel , Mirror , and the Copy , Cut , and Paste Special commands in the Clipboard group. Additionally, the Modify Features tool reference notes which tools reference these settings.

If a tool or command edits features on layers that are not specified as target and source layers, the tool ignores the field mapping settings and makes the edit without transferring attribute values and doesn't report an error.

To configure field mapping, complete the following steps:

1. On the ribbon Edit tab, click Editor Settings in the Manage Edits group.

   Alternatively, if the active editing tool references field mapping, click the Editing Options button and click Field Mapping .

   The Editor Settings dialog box appears.

2. Click the Field Mapping side tab.
3. Click the Target drop-down arrow and choose the feature layer for the features to which attribute values are to be transferred.

   Attribute fields defined for the layer appear in the Target column.

4. Click the Source drop-down arrow and choose the feature layer for the features from which attribute values are to be copied.

   By default, fields with matching field names and data types appear in the Source column.

   To change or add a field, for example, to add a field with a different name or data type, click the field and click the drop-down arrow. Allowable fields appear in the drop-down selector.

   

5. On the toolbar, click the following commands to reset, clear, or map matching fields.

   Reset	Restore field settings to the last saved configuration.
   Auto Match	Map all fields with matching field names and data types. This is the default setting.
   Clear	Remove all field settings.

6. Click the Expression tab to view or customize the ArcGIS Arcade expression created by the field settings.

   If fields on the Fields tab change, the current expression is overwritten.

   Note:

   Multiple lines separated by a comma are allowed in the same window. The following example returns field values in the source feature fields Elevation and Rotation to the target fields with the same name.

   return {
     "Elevation" : $sourceFeature['Elevation'],
     "Rotation" : $sourceFeature['Rotation']
   }

   To learn more, see ArcGIS Arcade.

7. On the toolbar below the expression window, click the following commands to reset, verify, or import and export label expression (LXP) files.

   Reset	Restore the expression to the last saved settings.
   Verify	Validate the expression. Line numbers and reasons for syntax errors are shown in the error message.
   Import	Import a label expression (LXP) file.
   Export	Export the expression to a label expression (LXP) file.

8. Click OK.

The dialog box closes.