Title: UK Address Postcode Validation Author: Ideal Postcodes Published: June 3, 2020 Last modified: September 29, 2026 --- Search plugins ![](https://ps.w.org/uk-address-postcode-validation/assets/icon.svg?rev=3260911) # UK Address Postcode Validation By [Ideal Postcodes](https://profiles.wordpress.org/idealpostcodes/) [Download](https://downloads.wordpress.org/plugin/uk-address-postcode-validation.4.5.0.zip) * [Details](https://es-hn.wordpress.org/plugins/uk-address-postcode-validation/#description) * [Reviews](https://es-hn.wordpress.org/plugins/uk-address-postcode-validation/#reviews) * [Installation](https://es-hn.wordpress.org/plugins/uk-address-postcode-validation/#installation) * [Development](https://es-hn.wordpress.org/plugins/uk-address-postcode-validation/#developers) [Support](https://wordpress.org/support/plugin/uk-address-postcode-validation/) ## Description Ideal Postcodes adds UK address validation and postcode lookup to WooCommerce. Help customers enter accurate billing and shipping addresses faster using UK address data from Royal Mail PAF®. Customers can either start typing an address and select a suggestion with Address Finder, or enter a postcode and choose an address with Postcode Lookup. The plugin works with WooCommerce checkout, billing and shipping forms, My Account address forms and other WooCommerce address forms. Faster address entry reduces typing and address errors while improving the quality of delivery address data. The WordPress extension is free to install. New Ideal Postcodes accounts include 50 free test credits with no credit card required. Pay-as-you-go address lookup charges apply after the trial. [Create an account](https://ideal-postcodes.co.uk) #### Address Finder and Postcode Lookup Choose the address search experience that works best for your WooCommerce store. _Address Finder_ Customers begin typing an address and matching addresses are suggested in real time. Selecting an address automatically fills the relevant WooCommerce address fields. _Postcode Lookup_ Customers enter a UK postcode and select their address from a list of matching addresses. You can enable Address Finder, Postcode Lookup, or both. [Read the WooCommerce setup guide.](https://docs.ideal-postcodes.co.uk/docs/integrations/woocommerce) Contact us if you get stuck. Drop by our [chat page](https://ideal-postcodes.co.uk) for immediate assistance or send us a message on one of our [support channels](https://ideal-postcodes.co.uk/support). #### Features * Address autocomplete on checkout shipping and billing pages * Address autocomplete 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 #### Why use Ideal Postcodes with WooCommerce? * _Speed up the Checkout Process._ Reduce the amount of typing required during checkout. Customers can search for and select their address instead of entering every address field manually. * _Increase Deliverability._ Help reduce spelling mistakes, formatting errors and incorrectly entered addresses before an order is submitted. * _Ensure Data Quality._ Capture consistent address information using authoritative UK address data from Royal Mail PAF®. #### Other Ideal Postcodes Integrations Ideal Postcodes also provides integrations and setup guides for other WordPress forms: * Gravity Forms Address Validation [See our guide](https://ideal-postcodes.co.uk/guides/gravity) * Contact Form 7 Address Validation [See our guide](https://ideal-postcodes.co.uk/guides/contact-form-7) * JetFormbuilder Address Validation [See our guide](https://docs.ideal-postcodes.co.uk/docs/integrations/jetformbuilder) * Ninja Forms Address Validation [See our guide](https://docs.ideal-postcodes.co.uk/docs/integrations/ninja-forms) * Formidable Forms Address Validation [See our guide](https://docs.ideal-postcodes.co.uk/docs/integrations/formidable) * Forminator Address Validation [See our guide](https://docs.ideal-postcodes.co.uk/docs/integrations/forminator) * Fluent Forms Address Validation [See our guide](https://docs.ideal-postcodes.co.uk/docs/integrations/fluent-forms) ### [3.10.2](https://github.com/ideal-postcodes/woocommerce/compare/3.10.1…3.10.2) (2025-11-10) ### Bug Fixes * correct button class assignment logic for postcode field ([dc9c8c9](https://github.com/ideal-postcodes/woocommerce/commit/dc9c8c9ef80e011dcf6a893339003df8f2515e4c)) #### 3.10.1 ### [3.10.1](https://github.com/ideal-postcodes/woocommerce/compare/3.10.0…3.10.1) (2025-10-27) ### Bug Fixes * **file:** bump woocommerce.min.js version to 1.1 ([7c5bc30](https://github.com/ideal-postcodes/woocommerce/commit/7c5bc30b2b84653f34ab005e9c5b333345c22c17)) #### 3.10.0 [3.10.0](https://github.com/ideal-postcodes/woocommerce/compare/3.9.3...3.10.0) ( 2025-10-24) ### Features * **Security:** Resolve CVE-2025-57923 ([92fe630](https://github.com/ideal-postcodes/woocommerce/commit/92fe630a7355f00d8fb5aa24de2eb592f9da95a6)) #### 3.9.2 ### Bug Fixes * **checkout-update:** Update checkout event fix #### 3.8.2 * Update Address Finder and Postcode Lookup to 5.2.6 and 3.1.6 versions * Axios security patch #### 3.8.1 * Tested up to WooCommerce 10.0.4 and WordPress 6.8.2 environment #### 3.8.0 * Add “Hide Address Fields Until Selection” option for separate address finder mode * Add warning about compatibility with postcode lookup feature * Improve address field visibility control when using separate address finder #### 3.7.2 * Tested up to WooCommerce 9.8.5 and WordPress 6.8.1 environment #### 3.7.1 * Only load admin settings script on the WooCommerce settings page * Clean up observers when postcode lookup fields are removed #### 3.7.0 * Hide postcode lookup field when a non-GBR country is selected * Fix address population for dynamically generated inputs in WooCommerce Blocks checkout #### 3.6.5 * Hide postcode lookup field when a non-GBR country is selected #### 3.6.4 * Update to properly handle the Gutenberg country selector #### 3.6.2 * Apply Axios security update #### 3.6.1 * Fix synchronization between the selected country and Address Finder country #### 3.5.9 * Enable removal of organisation name when option is enabled on configuration page #### 3.5.8 * Fix how countries are selected on checkout billing and shipping pages * Update integration tests #### 3.5.7 * Fix broken link in administrator’s plugin dashboard #### 3.5.6 * Update Postcode Lookup to version 2.0.0 #### 3.5.5 * Toggle the country context of Address Finder when a new country is selected in checkout * Fix address field binding for certain countries with dynamically generated inputs in WooCommerce Blocks checkout #### 3.5.4 * Improve Postcode Lookup layout on WooCommerce Blocks checkout #### 3.5.3 * Improve handling of the new WooCommerce Blocks country and county combobox #### 3.5.2 * Recompile JavaScript assets #### 3.5.1 * Fix issue with country selection for certain country input fields #### 3.5.0 * Add support for Blocks checkout * Add support for PHP 8.2+ #### 3.4.4 * Update Address Finder and Postcode Lookup to latest versions * Fix issue with admin Address Finder configuration override option * Add testing for PHP 8+ #### 3.4.1 * Allow Postcode Lookup style overrides #### 3.4.0 * Add search for WordPress customer user creation #### 3.3.2 * Declare compatibility for HPOS #### 3.2.3 * Add Postcode Lookup entity targeting * Add Postcode Lookup contextClass to enable styling #### 3.2.2 * Add tests for WooCommerce 5.9 #### 3.2.1 * Add tests for WooCommerce 5.6 #### 3.2.0 * Add Address Validation to WooCommerce Admin dashboard * Default county population to true * Test on WooCommerce 5.5 * Upgrade Postcode Lookup to 1.8 * Upgrade Address Finder to 2.2 #### 3.1.4 * Test on WooCommerce 5.4 * Test on WordPress 5.7 #### 3.1.3 * Update readme #### 3.1.2 * Test on WooCommerce 5.2 #### 3.1.1 * Upgrade Postcode Lookup to 1.7.2 #### 3.1.0 _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 (chat.ideal-postcodes.co.uk) 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 #### 3.0.6 * Add testing for WooCommerce 5.1 #### 3.0.5 * Use the country ISO code in the country field when a text input is detected. Previously the plugin inserted the country’s full name; it now sets only the ISO code #### 3.0.4 * Update Address Finder * Update Postcode Lookup * Rebuild JS payload to incorporate 3.0.3 #### 3.0.3 * Delay checkout refresh until after address population is complete #### 3.0.2 * Improve styling of default Postcode Lookup setup #### 3.0.1 * Update Address Finder to 1.8.0 * Update Postcode Lookup to 1.7.0 * Update and compress Address Finder CSS #### 3.0.0 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 (https://ideal-postcodes.co.uk/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. Any custom library overrides on the admin page must be translated into the new setup format. Deprecations: * 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 (https:// docs.ideal-postcodes.co.uk/docs/postcode-lookup) * The legacy Address Finder plugin is deprecated. This library will continue to be served until 4.0 is released. Please use Address Finder instead (https://docs. ideal-postcodes.co.uk/docs/address-finder) Chores: * Add testing on WooCommerce 5.0 * Remove data migration check #### 2.3.1 * Add tests for WooCommerce 4.9 #### 2.3.0 * Add tests for WordPress 5.6 * Add tests for WooCommerce 4.8 #### 2.2.0 * Add Postcode Lookup and Address Autocomplete configuration overrides #### 2.1.9 * Tested up to WooCommerce 4.7 * Test WordPress 5.5.3 #### 2.0.3 * Tested up to WooCommerce 4.6 #### 2.0.2 * Tested up to WooCommerce 4.3 #### 2.0.1 * Fix: restore manual checkout trigger #### 2.0.0 * 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 #### 1.0.5 * Manually fire checkout refresh on address population #### 1.0.3 * Update tested platforms for WordPress & WooCommerce * Release to WordPress plugins directory #### 1.0.2 * Automate version deploys to WordPress plugins directory #### 1.0.1 * Drop trademark for plugin submission #### 1.0.0 * Initial release ## Screenshots [⌊Address autocompletion on accounts pages⌉⌊Address autocompletion on accounts pages⌉[ Address autocompletion on accounts pages [⌊Address autocompletion on checkout billing and shipping pages⌉⌊Address autocompletion on checkout billing and shipping pages⌉[ Address autocompletion on checkout billing and shipping pages [⌊Admin console⌉⌊Admin console⌉[ Admin console [⌊Admin console, second tab⌉⌊Admin console, second tab⌉[ Admin console, second tab ## Installation #### Install from WordPress 1. Log in to your WordPress admin dashboard. 2. Go to `Plugins` > `Add New`. 3. Search for `Ideal Postcodes`. 4. Find the `UK Address Postcode Validation` plugin. 5. Click `Install Now`. 6. Click `Activate`. #### Manual Installation 1. Retrieve the plugin from the [Github repository](https://github.com/ideal-postcodes/woocommerce) and download the latest from the [releases page](https://github.com/ideal-postcodes/woocommerce/releases) 2. Unzip the release and upload the `uk-address-postcode-validation` directory to `/ wp-content/plugins/uk-address-postcode-validation` #### Configuration 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 Public API Key. You will need to add your Public 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. 4. Secure your API Key. Before going into production, restrict your API key to only accept requests from your website URL. See our [security guide](https://docs.ideal-postcodes.co.uk/docs/guides/api-key-secure) for detailed instructions on how to configure URL restrictions. ## FAQ ### How do I create an Ideal Postcodes Public API Key? You will need to create an account on Ideal-Postcodes.co.uk and generate a key from the dashboard. [View our guide](https://ideal-postcodes.co.uk/guides/account-setup) on how to create your first Public API key and enable automated top-ups. ### Is this free to test? Yes. New Ideal Postcodes accounts include free test credits that can be used to test the integration before purchasing additional lookup credits. [Start a free trial.](https://account.ideal-postcodes.co.uk/users/sign_up) ### How much does this cost? Ideal Postcodes uses pay-as-you-go address lookup pricing, with pricing dependent on lookup volume and account requirements. See our [pricing page](https://ideal-postcodes.co.uk/pricing) or [contact us](https://ideal-postcodes.co.uk/support) to find out more. ## Reviews ![](https://secure.gravatar.com/avatar/120230a9e3a333e816c7941a32f0809830c5ee4d74e392736192554873b2543e? s=60&d=retro&r=g) ### 󠀁[Address Look up & Validation – Works with Gutenberg](https://wordpress.org/support/topic/address-look-up-validation-works-with-gutenberg/)󠁿 [bigbudgie](https://profiles.wordpress.org/bigbudgie/) March 1, 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. ![](https://secure.gravatar.com/avatar/4cc5f9a3d4193c4f0dfdad2e78a6edcc03a38cb059a71775e6c6c8b226dd8a69? s=60&d=retro&r=g) ### 󠀁[Great plugin!](https://wordpress.org/support/topic/great-plugin-28407/)󠁿 [tad88](https://profiles.wordpress.org/tad88/) October 31, 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 [ Read all 3 reviews ](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/) ## Contributors & Developers “UK Address Postcode Validation” is open source software. The following people have contributed to this plugin. Contributors * [ Ideal Postcodes ](https://profiles.wordpress.org/idealpostcodes/) [Translate “UK Address Postcode Validation” into your language.](https://translate.wordpress.org/projects/wp-plugins/uk-address-postcode-validation) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/uk-address-postcode-validation/), check out the [SVN repository](https://plugins.svn.wordpress.org/uk-address-postcode-validation/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/uk-address-postcode-validation/) by [RSS](https://plugins.trac.wordpress.org/log/uk-address-postcode-validation/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 4.5.0 [4.5.0](https://github.com/ideal-postcodes/woocommerce/compare/4.4.0...4.5.0) (2026- 09-29) ### Bug Fixes * **checkout:** Remove the company name from address lines when populating the Company field ([7efe6d5](https://github.com/ideal-postcodes/woocommerce/commit/7efe6d56a60b28855bf13d750b62f0f6beb35d4a)) ### Features * **blocks:** Populate a third address line field in the Blocks checkout and keep third lines in address line 2 by default ([b6a16f0](https://github.com/ideal-postcodes/woocommerce/commit/b6a16f0d359181159160224ef0d4cb3ffcbe1089)) #### 4.4.0 [4.4.0](https://github.com/ideal-postcodes/woocommerce/compare/4.3.0...4.4.0) (2026- 07-01) ### Features * **checkout:** add configurable Address Finder and Postcode Lookup label settings( [d4579ab](https://github.com/ideal-postcodes/woocommerce/commit/d4579ab82787ba12e0c72554f004baafeb1d9e01)) #### 4.3.0 [4.3.0](https://github.com/ideal-postcodes/woocommerce/compare/4.2.0...4.3.0) (2026- 05-15) ### Features * **validation:** add US ZIP+4 to ZIP-5 truncation option ([4bacdd0](https://github.com/ideal-postcodes/woocommerce/commit/4bacdd09509df3076d721855d1b879ea507405e1)) * **validation:** improve US ZIP code setting label and description ([0bd2d02](https://github.com/ideal-postcodes/woocommerce/commit/0bd2d0207fb540184d1e81440e970e8c9618ff6b)) #### 4.2.0 [4.2.0](https://github.com/ideal-postcodes/woocommerce/compare/4.1.0...4.2.0) (2026- 05-14) ### Features * **checkout:** add Canadian province select support for classic checkout ([f176691](https://github.com/ideal-postcodes/woocommerce/commit/f176691a57bba7b71ad81d2c506c33294339702e)) * **test:** add Playwright e2e test suite alongside existing Cypress tests ([2e8a9a5](https://github.com/ideal-postcodes/woocommerce/commit/2e8a9a588c8998ccd3f1ccad6cc16ac183e1214c)) #### 4.1.0 * Improve reliability of address autocomplete on the WooCommerce Blocks checkout * Ensure address fields remain usable when the Blocks checkout re-renders or temporarily hides #### 4.0.0 This release introduces direct support for the WooCommerce Blocks checkout and adds optional address validation across checkout, account pages and admin. **Breaking Change:** On WooCommerce 8.0 and above, the plugin now uses the Blocks checkout integration instead of the classic jQuery checkout. Custom styling and configuration overrides applied to the classic checkout may need to be reviewed. * Add address autocomplete and postcode lookup support for the WooCommerce Blocks checkout * Add separate address finder mode with manual entry toggle and “Hide Address Fields Until Selection” support on the Blocks checkout * Add optional address validation with transliteration, ASCII filtering, line length limits and PO Box blocking on classic checkout, account pages and admin * Reorganise admin settings into a tabbed interface (Basic, Advanced, Validation) * Improve validation error display with configurable timeout and accessibility enhancements * Fix organisation field population on the Blocks checkout when the option is enabled #### 3.10.2 ## Meta * Version **4.5.0** * Last updated **3 hours ago** * Active installations **700+** * WordPress version ** 5.0 or higher ** * Tested up to **7.1.2** * PHP version ** 7.4.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/uk-address-postcode-validation/) * Tags * [address](https://es-hn.wordpress.org/plugins/tags/address/)[Address AutoComplete](https://es-hn.wordpress.org/plugins/tags/address-autocomplete/) [postcode](https://es-hn.wordpress.org/plugins/tags/postcode/)[validation](https://es-hn.wordpress.org/plugins/tags/validation/) [woocommerce](https://es-hn.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://es-hn.wordpress.org/plugins/uk-address-postcode-validation/advanced/) ## Ratings 5 out of 5 stars. * [ 2 5-star reviews ](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/uk-address-postcode-validation/reviews/) ## Contributors * [ Ideal Postcodes ](https://profiles.wordpress.org/idealpostcodes/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/uk-address-postcode-validation/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://ideal-postcodes.co.uk/)