UK Address Postcode Validation


This extension provides realtime address autocompletion lookup on your address forms, including billing and shipping. Ideal Postcodes address tools validates and accelerates customer entered address information to reduce cart abandonment and ensure correct delivery address capture.

Ideal Postcodes provides address autocomplete for your WooCommerce address forms. We specialize in the UK addressing data, drawing the most up-to-date & accurate UK dataset from Royal Mail on a daily basis. We have over 1,000 clients that use our address validation tools to speed up checkout, increase deliverability, and ensure data quality.

This extension adds address validation including realtime address autocompletion on your address forms. Our tools appear on your checkout and user account pages (for billing and shipping addresses). Our address validation tools speed up the checkout process and ensure that correct addresses are collected, thereby reducing cart abandonment and ensuring deliverability.

This extension is free to download and install. However, our address validation services requires a paid account at

Contact us if you get stuck. Drop by our chat page for immediate assistance or send us a message on one of our support channels.


  • Speed up the Checkout Process. Reduce the time it takes to accurately insert an address on your checkout
  • Increase Deliverability. Reduce failed deliveries by making address entry easier and less error prone
  • Ensure Data Quality. Access the most up-to-date and accurate address dataset in the UK with Royal Mail’s PAF® dataset


  • Address autocompletion on checkout shipping and billing pages
  • Address autocompletion on accounts pages
  • Post towns now capitalised by default (instead of all caps)
  • Checks if key is usable before enabling autocomplete
  • Optionally populate organisation name from selected address
  • Optionally populate county information


  • Address autocompletion on accounts pages
  • Address autocompletion on checkout billing and shipping pages
  • Admin console
  • Admin console, second tab


WordPress Plugins

  1. Install the plugin through the WordPress plugins screen

Manual Installation

  1. Retrieve the plugin from the Github repository and download the latest from the releases page
  2. Unzip the release and upload the uk-address-postcode-validation directory to /wp-content/plugins/uk-address-postcode-validation


When the plugin has been retrieved manually or via the plugins page,

  1. Activate the plugin through the ‘Plugins’ screen in WordPress
  2. Configure the plugin. Click on the WooCommerce link in the sidebar, then the Integrations tab on the settings page and finally UK Address Postcode Validation.
  3. Add your API Key. You will need to add your API Key from your Ideal Postcodes dashboard. Your first key will have a free test balance. To go live, you will need to prepurchase a lookup balance on your key.


How do I create an Ideal Postcodes API Key?

You will need to create an account on and generate a key from the dashboard. View our guide on how to create your first Ideal Postcodes API key and enable automated top-ups.

Is this free to test?

Yes. Your first key on your Ideal Postcodes account will carry a free test balance which you can use to verify and test your integration. When you are ready to go live, you will need to add a live balance to your Key either manually or with automated top-ups.

How much does this cost?

Prices range between 2 and 2.5p per lookup, with alternate pricing options available for specific sectors and volumes. See our pricing page or contact us to find out more.


16 marts, 2021
Such an elegant plugin and service. I looked at a variety of similar services and none came close to this. Easy to setup and is very cost effective. I raised an issue with support which was quickly rectified, they’re also incredibly polite and informative. Highly recommended!
1 marts, 2021
Have used other address and postcode validation software but have found Ideal Postcodes to work extremely well and is easy to configure for many form builder plugins. Works well in all browsers and can be configured with hidden fields, this enables me to make the form attractive and easy to use for my clients but ensures I get the correct address in the correct format with the various fields for easy import in to my database. Support has also been second to none, I would recommend Ideal Postcodes and the plugins, I am currently using on several websites.
31 oktobris, 2020
Cannot recommend this plugin highly enough. Very simple to use, and the cheapest postcode validation available in the UK for smaller volume users like me. The plugin installs very simply, and integrates with woocommerce beautifully. Their own website where you can set up and manage your account is fantastic for keeping tabs on all aspects of your usage, and is also simple to use. Their user support via chat channels is super responsive. This should be bundled with woocommerce for UK users. Nothing is simpler for postcode validation
Lasīt 3 atsauksmes

Autori un izstrādātāji

“UK Address Postcode Validation” ir atvērtā pirmkoda programmatūra. Šo spraudni ir veidojuši šādi cilvēki.


Izmaiņu žurnāls


  • Fix broken settings link on Plugins list page


  • Update Postcode Lookup to version 2.0.0


  • Toggle the country context of Address Finder when a new country is selected in checkout
  • Fix address field binding for certains countries with dynamically generated inputs in WooCommerce Blocks checkout


  • Improve Postcode Lookup layout on WooCommerce Blocks checkout


  • Better handling of new WooCommerce Blocks county and county combobox


  • Recompile JavaScript packages


  • Fix issue with country selection for certain country input fields


  • Add support for blocks checkout
  • Add support for php 8.2+


  • Update Address Finder and Postcode Lookup to newest versions
  • Fix issue with admin Address Finder config override option
  • Add testing against php 8+


  • Allow Postcode Lookup styles override


  • Add search for wordpress customer user creation


  • Declare compatibility for HPOS


  • Add Postcode Lookup entity targeting
  • Add Postcode Lookup contextClass to enable styling


  • Add tests for WooCommerce 5.9


  • Add tests for WooCommerce 5.6


  • Adds Address Validation to WooCommerce Admin dashboard
  • Defaults county population to true
  • Test on WooCommerce 5.5
  • Upgrade Postcode Lookup to 1.8
  • Upgrade Address Finder to 2.2


  • Test on WooCommerce 5.4
  • Test on WordPress 5.7


  • Update Readme


  • Test on WooCommerce 5.2


  • Upgrade Postcode Lookup to 1.7.2


Important. If you are using Postcode Lookup consider checking the styling of our Postcode Lookup tools on your checkout and user address book. This is particularly important if you are using custom styling to adapt our Postcode Lookup to your theme.

As always, please drop by chat ( if you have any questions about this change.

This update brings accessibility, usability and consistency improvements to our Postcode Lookup tools. In order to do this, the update reorganises Postcode Lookup HTML elements which may require you to update any custom styling you may have applied.

  • Reorganise Postcode Lookup HTML Elements to more closely match WooCommerce defaults
  • Adds “Postcode Lookup” label above Postcode Lookup search box for better accessibility
  • Improves touch target size for small screen sizes on Postcode Lookup


  • Adds testing for WooCommerce 5.1


  • Use country ISO code in country field if text input is detected. Currently Ideal Postcodes will set the country to it’s full name (United Kingdom) rather than ISO code (GB) if a text input field is detected. This behaviour has been changed so that the ISO code is added only


  • Update Address Finder
  • Update Postcode Lookup
  • Rebuild JS payload to incorporate 3.0.3


  • Delay checkout refresh to after address population is complete


  • Improve styling of default postcode lookup setup


  • Updates Address Finder to 1.8.0
  • Updates Postcode Lookup to 1.7.0
  • Update and compress Address Finder CSS


Substantial upgrade of Postcode Lookup and Address Finder.

Custom override users (advanced configuration) will be affected by Breaking Changes. You will not need to take action if your “Postcode Lookup Configuration Override” and “Address Autocomplete Configuration Override” configurations are empty.

If you are upgrading from 1.x please upgrade to 2.x first to ensure your configuration is migrated correctly.

Please reach out to support ( if this change brings backwards incompatible changes not listed here. We will address these immediately.

New Features:

  • Screen Reader Support. Both Postcode Lookup and Address Finder are now screen reader friendly. Any visually impaired user will now get audio cues when using our Address Validation tools.
  • Address Validation can be hidden when an unsupported territory/country is selected. This can be enabled from the admin panel.
  • Initialised Address Finder and Postcode Lookup controllers are now available at the global IdealPostcodes namespace for easier customisation
  • More custom callback options for Address Finder and Postcode Lookup
  • More custom styling options for Address Finder and Postcode Lookup
  • More custom behaviours like auto select single premise postcodes, hide/unhide address fields

Breaking Changes:

  • Both Postcode Lookup and Address Finder have been replaced. This means the any custom library overrides on the admin page will need to be translated into the new setup format.


  • The legacy Postcode Lookup jQuery plugin is deprecated. This library will continue to be served until 4.0 is released. Please use Postcode Lookup instead (
  • The legacy Address Finder plugin is deprecated. This library will continue to be served until 4.0 is released. Please use Address Finder instead (


  • Adds testing on WooCommerce 5.0
  • Remove data migration check


  • Add tests for WooCommerce 4.9


  • Add tests for WordPress 5.6
  • Add tests for WooCommerce 4.8


  • Added Postcode Lookup and Address Autocomplete configuration overrides


  • Tested up to WooCommerce 4.7
  • Test WordPress 5.5.3


  • Tested up to WooCommerce 4.6


  • Tested up to WooCommerce 4.3


  • Fix: Restore manual checkout trigger


  • Tested up to WooCommerce 4.2
  • BREAKING CHANGE: Settings page moved to Integration tab, under “UK Address Postcode Validation”
  • Feature: Adds postcode lookup to checkout pages


  • Manually fire checkout refresh on address population


  • Update tested platforms for WordPress & WooCommerce
  • Release to WordPress plugins directory


  • Automate version deploys to WordPress plugins directory


  • Drop trademark for plugin submission


  • Initial release