Postal Address Autocomplete

Our postal address autocomplete plugin integrates with WooCommerce to add physical address lookups to the checkout, and in the admin area (editing orders). The The plugin works with your existing Google API keys, so you don’t need to buy an external API subscription from another provider.

Because we use the either Google Places API or Google Places API (New) as the back-end, address lookup is done by means of a simple free-text search. The API then returns a list of possible matches.

Core settings

Settings for this plugin can be found in the back-end of your site, under Settings > Address Autocomplete

Create a Google API key

If you haven’t already created a Google API key, you should create one now. If you’re unsure how to create and secure a Google API key, our video will help you out.

The plugin supports bot “Places API” and “Places API (New)”. We recommend using the new API, but you can switch between the two systems to see what works best for your site’s requirements.

Set your Google API key

When you’ve got your API key, go to your website’s Settings > Address Autocomplete page, enter the API and save the changes.

Now you can add something to your cart, go to the checkout and test that the address lookup is working.

Troubleshooting

If there’s a problem with the API key, you’ll see one or more exclamation marks in the search box. If this happens, open your browser’s Developer Tools panel (usually the F12 key) and check for errors in there, like this:

Styling the search box

Grab an SVG icon from Font Awesome and copy the SVG code to your clipboard.

Pick an SVG icon from Font Awesome

Back in your site’s Address Autocomplete settings page, paste the SVG code and set your colours/border:

Action and filter hooks

Action name	Notes
address_autocomplete_before_enqueue_public_assets	Fires before the plugin’s standard JS & CSS are enqueued in the frontend.
address_autocomplete_after_enqueue_public_assets	Fires after the plugin’s standard JS & CSS are enqueued in the frontend.

Changelog

Version 1.10.0

Released: 2025-05-01

• Added a new option to capture Zip+4 for USA based addresses when using the New Places API (with our without the validation option).

Version 1.9.1

Released: 2025-04-07

• "Places API (New)" : Use more data from the Google Address Validation API if the results are available in the data.
• "Places API (New)" : Added an option to specify placeholder text in the search box (select2).

Version 1.9.0

Released: 2025-04-02

• Added support for the new Google Places API, called "Places API (New)" in Google's cloud console.
• When using the new places API, you can choose to use either a direct Place ID lookup (default) or use Google's Address Validation API. If you choose to use the Address Validation API, you need to add it to your Google cloud project.

Older releases

• If you enable the option to hide the billing address until the customer searches... you can now add a small "enter address manually" link.
• Added a couple of new style configuration options for changing text & link colours in the address lookup box.

• Minor update to the WooCommerce integration so we can use Google's administrative_area_level_3 field as the customer's Town/City if it's not returned by "postal_town" or "locality".

• Added a new option to disable auto-focus of the address search box when the country changes. This is to prevent the checkout page from jumping around after an update_checkout event, which seems to happen if the PayPal payment gateway is enabled.

• You can now choose to only populate Address Line 2 with the "subpremise" field - leaving it empty in all other cases.
• Updated language translations for FR, NL, ES and DE (machine translated).
• Updated the core Power Plugins library to the latest version.

• If the WooCommerce option to "hide billing address fields until searched" is enabled, avoid hiding the fields if Billing Address Line 1 already contains a value.
• Removed the (optional) text that WooCommerce injects into the "Search for your address" label (just set it to display:none).
• New settings to edit the label and placeholder for the address-search box.

• NEW: Added an option to the WooCommerce integration so you can hide the billing address fields until a the customer searches for an address.
• FIX: The billing/search address was being saved against a user's meta data. We now clear this so the lookup field is empty on each new page-load.

• Added an option to embed the address-lookup into the back-end of WooCommerce when creating/editing an order.

• Added an option to show the address lookup on the cart page, in the shipping calculations area (if it's enabled).

• Added an extra JavaScript call in the WooComemrce integration, to force WooCommerce shipping to recalculate. This is probably only needed by sites that use Astra theme. It's a minor patch.

• Minor patch to the checkout CSS to make sure the address lookup container is full-width
• Updated the Power Plugins core library to 1.6.0

• Minor revision to include the latest Power Plugins support library.

• Added es_ES, fr_FR and nl_NL translations (machine translated)

Added translations for de_DE (machine translated) and en_GB.

Initial public release

• Includes WooCommerce integration. Works with billing and shipping address fields in the checkout and in the My Account area (edit addresses).
• Includes basic style configuration settings for search box (colour, border and icon).

Second alpha release.

Initial alpha release