ShipWorks allows you to validate both domestic and international addresses, can notify you of address change suggestions and even automatically correct addresses for you.  This article will guide you through the available address validation settings in ShipWorks for international addresses, ways to perform international address validation and how to modify the main orders grid so that address validation statuses and suggestions are visible.

If you need information on Domestic Address Validation, please see this article.

First Things First

International address validation is available in version 5.20.0 or later of ShipWorks. You can check your version of ShipWorks by clicking on the Help tab and then on the About ShipWorks button.  For assistance with upgrading to the latest version of ShipWorks, please see this article.

In order to modify some of the ShipWorks settings mentioned in this article, you will need to be logged into ShipWorks as a user with administrator rights.

The Process

Default Address Validation Settings

By default, as orders are downloaded into ShipWorks, international address validation is performed for the Ship To addresses associated to the orders.  If an incorrect address is found, the address is not automatically corrected.  Instead, ShipWorks will notify you if the address is a Bad Address, will list any details related to a bad address, verify of the address is valid, and if appropriate will give you the option to select from a list of suggested corrections.

Example 1: The Ship To address is a valid address.  However, there is a minor suggestion available on how to correct the formatting of the address.  By clicking on the Suggestions link, you can view the original address, see the suggested correction, and select the suggestion so that the correction is applied to the address.  In the event that there are multiple suggestions, all suggestions are listed for you to select from.

Example 2: The Ship To address is a bad address and is listed as Type: Invalid and Validation Status: Bad Address. By clicking on the Details link in the Address Suggestions column you can view additional details about the address.


Example 3:  For some international addresses there is limited data available when validating the address.  In this example, the address was able to be validated only to the street address level.  The city, state/province and zip were not able to be validated.  There is still an available suggestion on how to correct the address. 

Additional Address Validation Settings

If you wish, you can change how and when ShipWorks performs international address validation.  You can also turn off international address validation completely.  

Address validation settings are at the store level.  This means that each store or marketplace you have connected to ShipWorks can be configured individually.  Here's how:

1.  Click on the Manage tab and then on the Stores button.

2.  Select the store for which you would like to modify the address validation settings.  Then, click the Edit button.

3.  Select Store Settings.

4.  Scroll down to the Address Validation section.  Then, select the desired setting from the International addresses: drop-down menu.  

The available settings are:

Automatically Fix Addresses - With this setting selected ShipWorks will automatically apply the correct international address if there is only one suggestion available.  If there are multiple address suggestions available, ShipWorks will list the suggestions for you and you will need to manually select the address you wish to apply from the list of suggestions.

In the below example, order 6007 has only one suggestion.  So, ShipWorks automatically Fixed the address for you.  However, order 6001 has multiple suggestions and ShipWorks only notifies you that there are multiple suggestions to select from.


Manual Validation Only - With this option selected, ShipWorks does not perform any address validation as orders are downloaded into ShipWorks.

In this example, you can see that the Validation Status for the newly imported orders is Not Checked.  You will need to manually perform address validation for these orders.  We'll show you how to perform address validation later in this article.

Disabled - This setting completely disables international address validation in ShipWorks.  ShipWorks does not perform any validation and you are not given the option to manually perform international address validation.

Applying International Address Validation Suggestions

From the Shipping Panel or Ship Orders Screen

1. Expand the To: address section to view the recipients ship to address.

2. Locate the Suggestion link located to the right of the Address label.  The link will tell you how many suggestions were found during the validation process. 

3. Click on the blue Suggestion link.  The original address will be listed along with all of the available suggestions.  Click on the suggestion you wish to be applied.

From the Main Orders Grid

1.  Click on the blue Suggestion link in the Validation Suggestion column. Then, select the suggestion you wish to be applied.

Manually Validating International Addresses

If you have International Address Validation set to Manual Validation only, you can validate addresses manually by:

On the Shipping Panel or Ship Orders Screen

1. Expand the To address section so that the recipients address is visible.

2. Click on the blue Validate link located to the right of the Address heading.

If the address is found to be bad, you will be notified that it is a bad address and can view additional details.

If there is only a single address correction found, the address will be automatically corrected for you.  You will be able to view the original address as well as the corrected address by clicking 1 Suggestion.

If there is a suggestion based upon limited available address validation data, you will be notified and have the opportunity to view additional details related to the limited data.

If multiple suggestions are found, you can select from a list of suggestions by clicking on the Suggestions link.

Did You Know??

Validating Addresses from the Order Editor

You can also validate international addresses from the Order Editor screen.  

1.  Select the order.  Then, click on the Home tab and then on the Edit button.

2.  Select Address. Then, click the Edit button.

3.  Click Validate or select from the list of Suggestions.

Address Validation Columns on the Orders Grid

By default, the main orders grid in ShipWorks does not display columns associated with address validation.  You can modify the grid so that you can see the Validation Status, Address Type, and Validation Suggestions columns for the Ship To and/or Bill To addresses.  Here's how:

1.  Click on the View tab and then click the Grid Columns button.

2.  Scroll down in the Column Order and Visibility list to locate the Address Validation columns you wish to enable.  Then, check the box to the right of the column(s) you wish to display.  Click OK.  The available address validation columns are:

Validation Status (shipping and/or billing) - Indicates the status of address validation; Not Checked, Bad Address, Has Suggestions, Suggestion Selected, or automatically Fixed.

Validation Suggestions (Shipping and/or Billing) - Shows you the number of address suggestions available, allows you to select from a list of suggestions and will give you additional details related to a bad address.


Type - Displays if the address is Residential or Commercial.  Also displays if the address has not been validated, is too ambiguous to validate, an international address or an international address with limited address validation data.

Rearranging Columns on the Grid

If you wish to change the order in which the columns are displayed on the orders grid, you can use the Move Up and Move Down buttons to do so.  Simply select the column you wish to move and click the appropriate button to move the column up or down in the list.

The Orders Grid with the shipping Validation Status and Suggestions columns visible.

Google Maps and Street Level View

ShipWorks allows you to add panels that will show you a Google Map view or a street level view of the address associated to a selected order.  This can be helpful when you are validating an address and would like to view the area on a map.  You can do it right in ShipWorks!  Here's how:

1. Click on the View tab and then on the Show Panels button.

2. Select Map to add a panel that will show a map view of the address, or select Street View to add a panel that shows the street level view of the address.

Still Need Help?

Please feel free to reach out to one of our awesome Customer Care representatives in St. Louis.  We are happy to help.