Configure field mapping

On the Edit tab, in the Tools group, click the Editor Settings dialog box launcher Launcher to configure field mapping. Field mapping specifies how attribute values are copied between features by tools that copy or transfer attributes.

Field mapping is also available from the tool pane on the Editor Settings button Menu with tools that use field mapping.

  1. On the Edit tab, in the Tools group, click the Editor Settings dialog box launcher Launcher.
  2. Click Field Mapping.
  3. Set the target and source layers.
    1. Click the Fields tab.
    2. Click the Source and Target drop-down arrows and choose the layers containing the fields between which you want to copy attribute values.
  4. In the Fields table, click a field drop-down arrow in the Source column and map it to the corresponding target field.

    To transfer geometry, map the Shape field to the corresponding target field.

  5. To reset or clear the field mapping settings, click the appropriate control on the toolbar above the Fields table.
    • Reset Undo—Restores the field mapping to the last saved settings.
    • Auto Match Switch Selection—Automatically maps fields based on matching field name and data type. This is the default setting.
    • Clear Clear Results—Overrides the current field mapping to explicitly transfer no attributes.
  6. To verify, import, or export an ArcGIS Arcade field expression, click the Expression tab.

    When an ArcGIS Arcade expression is mapping fields, subsequent changes to settings on the Fields tab override the expression. When this occurs, you must re-enter the expression.


    Use ArcGIS Arcade to embed logic that you can't otherwise accomplish with the standard controls—for example, to query the current value of a target field and copy the source attribute value only if it is greater than the target value.

    ArcGIS Arcade is a scripting language that is used to evaluate embedded expressions, perform calculations, and return values used by a specific function—for example, in an attribute rule, a label, or a field calculation.

    Field values maintain their data type. Inputs and output types are determined by the profile of the function for which the expression is evaluated. Multiple lines separated by a comma are allowed in the same window.

    The following example copies the values in the source feature fields Elevation and Rotation to the target fields with the same name.

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

    For field mapping variable names, see Profiles in the ArcGIS Arcade developers guide.

  7. Click OK to save your settings and close the dialog box.

Related topics

In this topic