Rematch locations converted from a table

After a table of addresses is geocoded, you may find that not all of the addresses or locations in your table were matched to the results you expected; for example, points may not have been created in the location you expected or may lack the precision you were expecting. Inspecting your table may reveal the reason for an unexpected match; for instance, your input may have been missing a city field, or the street name may have been misspelled. For cases such as these, you can review the results, make corrections in your table, and update your geocoding results. You can use the interactive rematch tool in ArcGIS Pro to manually review addresses to make corrections to your original input and geocode again, reposition the location of the matched address, or select a different candidate. You can also modify the locator's settings and geocode the addresses that were matched to unexpected results. This process is called rematching.

If you selected Location only for the Output Fields parameter when geocoding your table (using Geocode Addresses, Geocode File, Geocode Locations From Table, or Geocode Table), you must select the locator you want to use for rematching the output feature class in the locator view of the Rematch Addresses pane and map the Input Address Fields again.

Rematch addresses


An ArcGIS Online subscription is required to rematch unmatched addresses or automatically rematch all addresses in the geocoded feature class using the ArcGIS World Geocoding Service. If you have not signed in, you are prompted to sign in to your ArcGIS Online for organizations account.

If you rematch a geocoded feature class that was geocoded using the ArcGIS World Geocoding Service, credits are consumed from your organizational account. Any time a match action is performed in the Rematch Addresses pane, that action consumes credits. If you geocoded your feature class with any other locator, credits are not consumed.


This topic covers how to interactively rematch addresses using the Rematch Addresses pane, but you can also rematch specific addresses or groups of addresses with SQL queries using the Rematch Addresses geoprocessing tool.

Complete the following steps to rematch addresses in a geocoded feature class in ArcGIS Pro using the interactive Rematch Addresses pane:

  1. In the Contents pane, right-click a geocoded feature class that you want to rematch, click Data, and click Rematch Addresses Rematch Addresses to open the Rematch Addresses pane.

    This allows you to view and examine addresses that failed to match, as well as addresses that failed to match at or above a specified match level.


    The attribute table for the feature class that you select opens automatically alongside the Rematch Addresses pane.

  2. Use the Rematch Addresses pane to review the incorrectly matched addresses (or unmatched addresses) individually. .

    The tool allows you to review the addresses one by one to address only the current problematic address

  3. Inspect the input address and correct it if there are errors.

    Sometimes addresses fail to match because of incomplete reference data. If necessary, you can inspect the input address fields for errors, update the fields that have errors, and geocode the address again to get an updated list of candidates.

  4. Review the candidate list to see if you can find a possible match. Optionally, match the address to a candidate in a reasonable proximity.
  5. Review and rematch addresses that tied or matched if you're not satisfied with the match that your locator found automatically.

    In some cases, you may get addresses that falsely match to the wrong location.

  6. If this occurs, use the Unmatch button Unmatch to remove the match if no appropriate match exists one record at a time. However, if you want to unmatch a group of addresses, select them and use the Unmatch All Selected button Unmatch All Selected.
  7. For addresses that could not find any candidates, but for which you know the location on the map, use the Pick from Map button Pick from Map to match the address by clicking a location on the map.

See the Rematch addresses from a geocoded feature class tutorial to learn more about a typical workflow for rematching a geocoded feature class in ArcGIS Pro.

Rematch Addresses pane

The Rematch Addresses pane is divided into several parts, which are explained in detail below. Relevant data and tools are grouped together.

Rematch Addresses pane

You can resize the upper and lower portions of the pane by pointing to the line between the two parts of the pane. When the pointer changes to a resize pointer, you can click and drag to increase or decrease the size of the two parts proportionately. You can also click the arrow buttons on the right side of the line in the center of the pane to collapse the upper or lower portions of the pane. Once collapsed, you can click the arrow pointing in the opposite direction to expand that portion of the pane.

It is recommended that you keep both portions of the pane open simultaneously, since you need information from both portions of the pane to know which address you are rematching and the candidate to which you are geocoding the address.

Assess match success

You can view the total number of matched, unmatched, and tied addresses in the geocoded feature class to assess the progress of your geocoding project.

Rematch progress

Your geocoded feature class is divided into three categories in the Rematch Addresses pane: Unmatched, Matched, and Tied. You can click any of the three tabs to see the total number of results in each category. In the example above, 46 addresses are in the Matched category. Although not pictured, the same example has three results in the Unmatched category and one result in the Tied category. As you rematch addresses, the addresses move automatically into the Matched category, so when you finish the process, that should be the only visible category; therefore, the example above contains all 50 records at the end of the rematch process.

View geocoding results

The three categories displayed in the upper portion of the Rematch Addresses pane provide a way for you to view and change the address that is currently active in the pane; only the active address can be rematched or matched.

Clicking the arrows on either side of the numbers showing which record is currently active selects the previous or next address on the selected category tab (Unmatched, Matched, or Tied).

The active address displays a default set of fields drawn from the attribute table of your geocoded feature class. When you interactively match an address, some values automatically generate as geocoding output, such as the values for the Score, Side, Match_type, and Match_addr attributes. All the attributes from your original table of address data are also present in the geocoding results table. You can add or remove the fields from the table you want to view in the Rematch pane for each record by clicking the Select Fields button Select Fields and checking the check boxes for the fields you want displayed.

The address candidates for the active address display in the lower portion of the pane. For each available candidate, a set of default fields always displays: Matched, Address, Type, and Score. You can add additional fields and hide any of these fields using the Select Fields button Select Fields. The Menu button Menu allows you several options. You can zoom to view all candidates displayed on the map by clicking Menu Menu and clicking Zoom To All Map All Suggestions. You can re-sort the candidates based on their default sort order by clicking Menu Menu and clicking Default Sort Order Default Sort Order. You can also select a set of addresses from your geocoded feature class to focus on in the Rematch Addresses pane by using queries. Click Menu Menu, and click Predefined Queries to view a list of options for available preset queries that you can use on your table or for the option to create a custom query. If you make a selection by choosing one of the predefined queries or creating one of your own, the Rematch Addresses pane refreshes and displays only those records selected by your query rather than all the records in your table. Those records still sort into the three available categories of Unmatched, Matched, and Tied.


You can also make selections manually in the attribute table for your geocoded feature class, which opens automatically when you begin the rematch process. The Rematch pane is contextually tied to the attribute table. Select rows or run queries directly on the table to update the records displayed in the Rematch Addresses pane.


Editing the fields prefixed with IN_ will update the fields used to generate candidates for that record, and if Auto Apply is checked, the candidates for that record update accordingly.


If the values for Predefined Queries don’t meet your needs, you can create a custom query to select a set of addresses. Click Menu Menu, click Predefined Queries, and click Custom Query to open the Select Layer by Attribute geoprocessing tool. In the Expression parameter, construct a query. The query can be saved to a query expression file (.exp file extension) that can be loaded into the query builder in future rematching workflows.

Match, unmatch, and rematch addresses

All of the records in your geocoded feature class can be matched, unmatched, or rematched. You can match all records that failed to match; rematch matched records that you review and find to be unsuitable matches; unmatch matched records that you find are matched to the wrong location; or select the best match of a set of tied candidates. You can match the active address in the upper portion of the Rematch Addresses pane to an address or location by using the lower portion of the pane. If a suitable candidate displays automatically in the pane, you can match to it by clicking it and clicking Match Match. If a suitable candidate is not displayed, you have two options. If you are able to correct any fields for the original record by editing them in the upper portion of the pane, the corrections may result in new candidates being generated. If you check the Auto Apply check box, all updates you make in the upper portion of the pane automatically update your table and regeocode your record, which refreshes the candidates displayed in the lower portion of the pane. If manually correcting the record still does not generate a suitable candidate, click a location on the map manually to generate a point, and match to the latitude and longitude of the location you clicked. To do this, click Pick from Map Pick from Map, and click the location on the map to which you want to match. A new candidate with the latitude and longitude of that location generates in the candidate list in the lower portion of the pane. You can then click that candidate and click Match Match.


When you match a record using Pick from Map, you have the option to cache the matched location for future use. You will be prompted to decide whether you want to save locations, and if you choose to do so, future sessions that include records with the same input value will include the previously cached location as a candidate in the lower half of the Rematch pane if you enable Display cached match candidates.

Rematch Cache

Import cache file

You can import a cache file from any location on disk or from a network share to overwrite the cache on your local system. To do this, click Cache Options Unselected geodatabase and select Import Cache File Import Report in the upper portion of the Rematch Addresses pane under the drop-down menu and select a cache file to import. A warning will pop up about overwriting the cache on the local system. Click Yes to replace the existing cache file on the local system.

Export cache file

You can save a copy of the cache file from your local system to any location on disk or to a network share for syncing across your organization. To do this, click Cache Options Unselected geodatabase and select Export Cache File Export in the upper portion of the Rematch Addresses pane under the drop-down menu and browse to a location on disk or on a network share to save the cache file to. Click Save to save a copy of the cache file to the specified location.

Auto rematch

There are cases when you may want to perform a bulk update of multiple records without going through each one manually. This can be due to changes made to any of the locator properties, such as minimum match score or categories to support. In this case, you can initiate the automatic rematch functionality to redo the matching process by clicking Auto Rematch Auto Rematch. This only applies to the selected records if you have selected one of the Predefined Queries options, created a selection based on a custom query, or manually selected records in the Attribute Table Open Table of the geocoded feature class. If no selection is defined, all records are processed.

Match all selected

Click Match All Selected Match All Selected if you have selected a group of records manually or created a selection set based on a custom query and need to match all of the selected records to a single candidate. For example, a group of records contains the same wrong city or postal code and you want to match them all to the same candidate at once. Using Match All Selected Match All Selected speeds up the process of rematching the geocoded feature class.

Unmatch all selected

Click Unmatch All Selected Unmatch All Selected if you have selected group of records manually or created a selection set based on a custom query and need to unmatch all of the selected records. For example, a group of records were matched with a score that was too low and you want to unmatch them all at once. Using Unmatch All Selected speeds up the process of reviewing and rematching the geocoded feature class.

Match with new locator

Select Add or Modify Locator from the Locators drop-down menu to attempt rematching with a different locator. When you select this option, the Rematch Addresses pane requires you to map the fields from your table to the new locator, save your changes, and then return to the main view of the Rematch Addresses pane to view available candidates.

Once you have added a new locator to the Rematch Addresses pane and mapped fields, that locator remains in the Locators drop-down for the remainder of your rematch session. These locators and field mappings are not saved if you save your project and exit the application, and you are required to add the locator and map fields again if you do so.

Modify geocoding options

Select Add or Modify Locator from the Locators drop-down menu to modify the geocoding options of any locator you want to use for rematching.

Geocoding options in Rematch Addresses pane

Only the geocoding options that are supported for a given locator are displayed. Modifying the geocoding settings does not change the original settings in the locator. As a result, any geocoding settings that you modify are not saved if you save your project and exit the application, and you will be required to modify geocoding options again if you do so.

Save your edits

When you finish matching unmatched addresses and reviewing and rematching matched or tied addresses, save your edits to make sure all of your changes are saved to your geocoded feature class. Updates to both the table and the points in the feature class will be saved. To save, click the Save Edits button Save Edits in the lower portion of the Rematch Addresses pane. You can then close the pane.

Related topics