Skip to main content
Skip table of contents

Parse Address

The Parse Address tool is designed for processing mailing-list files containing United States addresses. Rather than actually correcting addresses containing errors (a process termed address standardization), the Parse Address tool cleans up inconsistent address data. The Parse Address tool:

  • Accepts input fields containing unknown or poorly fielded information, and analyzes the contents of each input field.

  • Parses the input address into its components: Name, Delivery Address, and Last Line Address (City, State Zip)

  • Further parses the address into sub-components: City, State, Zip, House number, Predirectional (such as N, S, E, W), Street, Street suffix, Postdirectional, Unit designator (Apt, Suite, and so forth), and Unit Number.

  • Generates multiple address candidates to improve address matching and deduplication results.

Once you've parsed addresses, you can do two things more easily:

  1. Accurately compare address information for the purpose of merge/purge, householding, or fuzzy-matching.

  2. Input the results into Data Management's Standardize Address tool or another address-standardization program. Since Data Management will correct poorly fielded data, you will get better results than if you had started with raw information.

The Parse Address tool does not generate pre-sorted or CASS-certified mailing lists. If you require CASS certification, you should license Data Management's Standardize Address tool.

Parse Address tool configuration parameters

The Parse Address tool has one set of configuration parameters in addition to the standard execution options:

Map available input fields

Delivery address

Input field containing the delivery address.

Last line as

Select Single field if city, state, and ZIP Code are contained in a single field, or City, State and ZIP if they are separate fields. This is optional and defaults to Single field.

Last line address

If Last line as Single field, the input field containing the City, State, and ZIP Code.

City

If Last line as City, State and ZIP, the input field containing the City.

State

If Last line as City, State and ZIP, the input field containing the State.

ZIP

If Last line as City, State and ZIP, the input field containing the ZIP Code.

Standard output fields

Deliv address

Output field for street address. This is optional, and defaults to Parsed_Address with a length of 64.

City

Output field for city. This is optional, and defaults to Parsed_City with a length of 28.

State

Output field for state. This is optional, and defaults to Parsed_State with a length of 2.

ZIP

Output field for ZIP Code. This is optional, and defaults to Parsed_Zip with a length of 5.

Street component output fields

Number

Output field for street number. This is optional, and defaults to Parsed_Number with a length of 10.

Predirectional

Output field for street predirectional. This is optional, and defaults to Parsed_Predir with a length of 2.

Street

Output field for street name. This is optional, and defaults to Parsed_Street with a length of 28.

Street suffix

Output field for street suffix. This is optional, and defaults to Parsed_Suffix with a length of 4.

Postdirectional

Output field for street postdirectional. This is optional, and defaults to Parsed_Postdir with a length of 2.

Unit designator

Output field for unit designator (such as APT or STE). This is optional, and defaults to Parsed_UnitDes with a length of 4.

Unit number

Output field for unit number. This is optional, and defaults to Parsed_UnitNbr with a length of 8.

if multiple candidates

Select whether to output the best candidate, the top five candidates, or all plausible candidates. This is optional and defaults to output the best candidate.

Configure the Parse Address tool

  1. Select the Parse Address tool, and then go to the Configuration tab on the Properties pane.

  2. Map available input fields:

    • Select the Delivery address box and select the input field that contains the delivery address.

    • Select the Last line as box:

If

Do this

There is a single last line field

Select Single field, and then select the Last line address input field.

There is not a single last line field

Select City, State and ZIP, and then select the City, State, and ZIP boxes to select the appropriate input fields.

  1. Specify output fields:

    • Select the Delivery Address, City, State, and ZIP boxes and specify output fields to receive the address components.

    • In the Street component output fields section, select the Number, Predirectional, Street, Street Suffix, Postdirectional, Unit Designator, and Unit Number boxes and specify output fields to receive the address components.

    • If the specified output fields do not already exist in the input file, they will be created as new fields of type TextVar, using the name you specify and the sizes given below. If the output fields already exist in the input file, the fields must be large enough to handle the standard size of the components as specified below, or results may be truncated.

Output field

Default field size

Parsed_Address

64

Parsed_Number

10

Parsed_Predir

2

Parsed_Street

28

Parsed_Suffix

4

Parsed_Postdir

2

Parsed_UnitDes

4

Parsed_UnitNbr

8

Parsed_City

28

Parsed_State

2

Parsed_Zip

5

  1. Select If multiple candidates to select whether to output the best candidate, the top five candidates, or all plausible candidates.

  2. Optionally, go to the Execution tab, and then set Web service options.

Input addresses with nine-digit ZIP Codes (ZIP+4) are output as standard five-digit ZIP Codes. If your input addresses contain nine-digit ZIP Codes, you may wish to keep these Zip Codes by not specifying a ZIP output field.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.