WooCommerce Address Validation

The WooCommerce Postcode / Address Validation extension connects your store to one of several providers, letting you easily provide US address validation, postcode lookup for the UK or NL, or offer international address lookup.

To perform lookups or validation, this plugin will connect your store to your account with one of the following services:

1. Download the extension from your WooCommerce dashboard
2. Go to Plugins > Add New > Upload and select the ZIP file you just downloaded
3. Click Install Now, and then Activate
4. Click the Configure link and read the next section to learn how to setup and configure the plugin.

Plugin settings can be found under WooCommerce > Settings > Address Validation. Here you’ll select your provider and configure general settings, along with some provider-specific settings.

General Settings can change based on your selected provider.

• Provider – Select the provider you’d like to use for address validation or postcode lookup.
• Debug Mode – Enable this to output debugging information on the checkout page. As a best practice, you should leave this disabled unless you experience issues with the plugin.
• Classify Addresses? – (US providers) Enable this to save an address classification (Residential or Commercial) to the order.
• Force Customer to lookup address via postcode – (Postcode lookup providers) Enable this to force customers to use postcode lookup; address fields will be hidden until lookup is used. Note that once the customer clicks “Lookup Address”, the address fields are displayed regardless of whether the lookup is successful.

Upon signup, Loqate offers a limited amount of free lookup credits during the trial period. Once the credit or trial has expired, depending on region, a paid account will be required. Loqate can be used for address lookup / auto-complete in any country with a paid account. Please ensure you have enough credits in your account to allow for uninterrupted use of the service.

• Service Key – Enter your service key from Loqate. You can follow the instructions below to get this.
• Validate International Addresses – Enable this to allow address auto-complete for addresses outside of the US. When disabled, only US addresses will use Loqate to lookup addresses.

Postcode.NL offers NL address lookup via postcode. A customer can enter his or her postcode to lookup a full address; this auto-completes the checkout fields when selected.

• Application Key – Enter the application key from your Postcode.NL account. You can follow the instructions below to get this.
• Application Secret – Enter the application secret from your Postcode.NL account. You can follow the instructions below to get this.

The legacy Loqate integration offers UK address lookup via postcode. A customer can enter his or her postcode to lookup a full address; this auto-completes the checkout fields when selected.

• API Key – Enter the API key from your Loqate Account. You can follow the instructions below to get this.
• API Username – Enter the username associated with your Royal Mail account. If you do not have a Royal Mail account, leave this blank.

Postcode Software offers UK address lookup via postcode. A customer can enter his or her postcode to lookup a full address; this auto-completes the checkout fields when selected.

• Account Number – Enter the account number for your Postcode Software account. You can follow the instructions below to get this.
• Password – Enter the password for your Postcode Software account. You can follow the instructions below to get this.

Fetchify offers UK address lookup via postcode. A customer can enter his or her postcode to lookup a full address; this auto-completes the checkout fields when selected.

• Access Token – Enter the access token from your Fetchify account. You can get this by following the instructions below.

To complete set up, you’ll need credentials from your chosen service to connect the plugin to your account. Please read the instructions for your service to get account API or Service Key credentials for your store.

• Loqate
• Postcode.NL
• Loqate (legacy UK)
• PostcodeSoftware.net
• Fetchify

A Loqate account is required to use address auto-complete via Loqate. Merchants in any country can use Loqate to auto-complete addresses in all countries they sell to.

Sign into your Loqate account and follow these steps:

1. Click the “Add service” button at the top of your account dashboard.
   
2. Click on “API key” to create a new key for your store.
   
3. Copy the service key generated by Loqate:
   
4. Enter this service key in the plugin settings, then save your settings.
5. Optional: You can adjust the name of this key under “Configuration”, and set limits under “Limits”, such as restricting the number of lookups per day, limiting this key to a single URL for your site (recommended), or limiting the number of lookups by customer.

That’s it! You can now lookup and auto-complete addresses via Loqate.

Log in to your Postcode.nl account and create an application for use with your web store. After signing up, you will receive an email containing an application key and secret, which is needed to integrate with this extension.

Once you have this information, you can add it into the text box on the WooCommerce > Settings > Address Validation > Postcode.nl page and save your settings.

That’s it! Your customers can now lookup their address via Postcode on the checkout page.

Please follow the setup steps described above for your Loqate account — you’ll use your new “Service Key” in the “API key” field within the plugin settings.

Enter your PostcodeSoftware.net username and password into the text boxes on the WooCommerce > Settings > Address Validation > PostcodeSoftware.net, then save your settings.

That’s it! Your customers can now lookup their address via Postcode on the checkout page. You may want to test your checkout to make sure everything is working correctly.

First, login to your Fetchify account (you can sign up for a free trial with 30 lookups), then follow these steps:

1. Click “Access Tokens & Statistics” on the left, then click on your access token:
   
2. Copy the token value:
   
3. Enter this token in the plugin settings and save them.

Click on your token and copy the Access Token information:

That’s it! Your customers can now lookup their address via Postcode on the checkout page.

Postcode lookup, address auto-complete, or address verification will help your customers complete checkout accurately, ensuring that your shipments are going to the right place.

Each provider works slightly differently, but here are examples of how each type of lookup will function on your checkout.

Loqate provides address auto-completion for customers in any country. At checkout, customers can begin to enter an address, and Loqate will display a list of suggestions for the currently selected country. Customers can then select an address from the list, and address fields will be populated automatically.

See an example of Loqate in action.

Postcode lookup works the same way for UK and NL providers: Postcode.NL, Postcode Software, and Fetchify.

Postcode lookup allows the customer to enter a postcode, and then select an address from a list of suggestions. This will populate all checkout fields once an address is selected. You can even opt to hide the address fields until the lookup is used.

See an example of postcode lookup in action.

Postcode or address lookup is available via the “My Account” section for your site as well. While editing or adding new addresses, customers can use your configured provider to lookup or validate an address.

Postcode lookup can be used as well based on your settings and configured provider.

Having trouble? Check if these pointers help you solve your problem before posting a support request:

• Check that you have entered your API key/Access Token correctly.
• Double-check that you have entered your API key correctly. 😉
• Confirm that you have enough credits with your selected provider to perform verifications or lookups.
• Double-check that you have enough credits with your selected provider. 😉 for example, Loqate will say it can’t retrieve an address when you’re out of credits:
  
• Verify that there are no javascript errors on the checkout page — address lookup and verification rely on checkout javascript to be functioning properly. If you have a third-party theme or plugin that is breaking your javascript, it will likely affect this plugin as well.
• Ensure that the country field is present on your checkout page so the plugin can get accurate results. If you’ve customized your checkout and removed this, it can cause issues with address lookup.
• Worried about orders going through if US Validation fails? Please see our FAQ below.
• Enable Debug mode by going to WooCommerce > Settings > Address Validation and checking the “Debug Mode” checkbox. This will output information to the checkout page that will help in locating the source of the issue.
• If these steps don’t help narrow down the issue, please submit a help request and we’d be happy to assist.

If your postcode lookup results don’t have house number data, please ensure that your PostcodeSoftware account has Premise Level Credits added to it. This will ensure that premise-level data, such as the house numbers, is included in the results PostcodeSoftware returns.

Q: Can I use postcode lookup or address validation while adding an order in the admin?
A: Afraid not, sorry! This feature is available for customer use on the checkout and my account pages, but not from within the orders admin. If you’d like to see changes like this to our plugins, you can suggest them or vote on the ideas board.

Q: Help! My customers can still check out even though the address is not validated.
A: This is the expected behavior of the plugin and is part of the way the address validation libraries work.

Validation will suggest the “recommended” correction, but it will not block an order from processing if validation fails. The customer must ensure the address is correct, as there are legitimate reasons it may not validate; for example, it may be a new address / new construction that Loqate doesn’t have logged yet, and the order should not be blocked as a result.

This also ensures that, if for some reason the validation service’s servers are ever unreachable, the checkout isn’t completely locked down if it can’t validate addresses.

Q: Can I use this with One Page Checkout?
A: Yes! One Page Checkout is supported in Postcode / Address Validation from version 1.4.0 and onwards.

Q: Why isn’t the postcode lookup at the top of checkout? Why does it look strange on my checkout page?
A: WooCommerce core places the country field first in the checkout since the selected country affects the remaining fields. Similarly, the Address Validation postcode lookup is tied to the selected country because the postcode lookup providers bundled in the extension only support a single country (but shops often sell to multiple countries). As we want the postcode lookup fields to only appear when the supported country is selected by the customer, we make sure the lookup fields are tied with the country field and are typically displayed first.

If you’ve moved the country field away from the top of the page (for example, by using the Checkout Field Editor), then the Address Validation fields will go with it :). The extension assumes the billing and shipping country fields have not been moved and appends the postcode lookup fields below the country field. Placing the postcode lookup fields anywhere else breaks the user experience and defies the purpose of the plugin: to allow customers a quick way to lookup their address via a postcode rather than filling out all fields. We highly recommend that you keep the country field first on your checkout template.

If this is impossible, you could use the snippet below (or something similar), but please note that customization requests / custom code are not included in our support policy:

Q: Why is SmartyStreets no longer available as a provider?
A: SmartyStreets retired the API that was integrated with our plugin on October 4, 2022. They previously suspended new account connections through this API, and with the retirement all existing account connections ceased functioning as well. As a result, we removed SmartyStreets as a provider option. We recommend setting up a Loqate account and using their service as a provider to continue validating US addresses with our extension.

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with support via the help desk.