what3words Autosuggest Plugin


what3words Autosuggest Plugin

The what3words Autosuggest plugin helps you capture what3words addresses at checkout, using an address validation field. By giving a what3words address, your customers can accurately pinpoint their desired delivery destination.

what3words is a global addressing system that provides the simplest way to communicate location. It has divided the world into 3 metre squares and assigned each one a unique address made of just 3 words. It is more accurate than traditional street addressing, and even allows location information to be captured for places without addresses, such as parks or beaches.

How does this help your business?

It’s quick and easy to implement the what3words AutoSuggest Plugin. what3words addresses can be converted to GPS coordinates, which can then be passed onto delivery drivers. With a what3words address, deliveries can then arrive precisely in the right place and on time, giving a more reliable delivery experience for your customers.

And for your customers?

Your customers will have the option of providing the what3words address for their delivery location at the checkout. This gives them a way of providing a delivery location without the need to add complicated delivery instructions, and helps give them peace of mind that their delivery will be made to the right place, helping them to trust your business.

How does it work?

This plugin allows you to easily add capturing and validating a what3words address to a form on your WordPress powered site.
Powered by our AutoSuggest feature, the what3words address field returns suggestions based on full or partial what3words addresses, helping users with the following types of input error:

  • typing errors
  • spelling errors
  • misremembered words (e.g. singular vs. plural) or words in the wrong order

We recommend using the plugin when you want to capture a precise location from a user, such as a customer’s front door or specific entrance of a larger building.


Enabling the plugin in a post or page

To enable the plugin on a post or page, simply add a text input field contained inside a form, and add the field’s id to the plugin’s Input Selector(s) configuration option as described below.

what3words API settings

You’ll need a what3words API key to use this plugin, as it authenticates and interacts with the what3words API.
If you don’t have a what3words API key yet, you can quickly and easily sign-up and register for one. It will just take a few minutes to do!

WooCommerce Support

The plugin also allows you to automatically add a 3 word address validation field to a WooCommerce checkout form and save the 3 word address against the customer’s order details. By enabling WooCommerce checkout integration, the #shipping_w3w and #billing_w3w selectors will be automatically added to the list of Input Selector(s).

Is there a web site for this plugin?

Absolutely. Go to the what3words AutoSuggest plugin home page for the latest information. There’s also the official WordPress plugin repository page and the source for the plugin is on GitHub as well.

what3words AutoSuggest plugin isn’t available in my language; can I submit a translation?

WordPress and this plugin use the Gnu gettext tools to support internationalisation. The source file containing each string that needs to be translated ships with the plugin in what3words-searchbox/lang/src/what3words-searchbox.po. See the I18n for WordPress Developers page for more information or get in touch for help.

I have a question that’s not answered here; what do I do?

Have a read of the what3words Knowledge Base, which contains many more frequently asked questions and their answers.

Filter Support And Usage

what3words AutoSuggest plugin supports a single filter to change the default set of installation settings and options at plugin activation time.

More about what3words

what3words is available in 45+ languages, with pre-assigned, standardised 3 word addresses that are much easier to remember than lat/long coordinates.

Find our full developer documentation here: what3words.com

You can learn more about our privacy policy here: what3words Privacy Policy


  • Simple and fast to integrate
  • Powered by what3words AutoSuggest
  • Use 3 word addresses for precise and reliable deliveries
  • Accept 3 word addresses at checkout


  • You can install what3words AutoSuggest plugin automatically from the WordPress admin panel. From the Dashboard, navigate to Plugins / Add New and search for “what3words” and click on the “Install Now” button.
  • Or you can install what3words AutoSuggest plugin manually. Download the plugin Zip archive and uncompress it. Copy or upload the 3-word-address-validation-field folder to the wp-content/plugins folder on your web server.
  • Activate the plugin. From the Dashboard, navigate to Plugins and click on the “Activate” link under the entry for What3words Searchbox.
  • Customise and configure the plugin; from the Dashboard, navigate to the Settings / what3words AutoSuggest plugin page or click on the “Settings” link from the Plugins page on the Dashboard.
  • Click on the “Save what3words AutoSuggest plugin Settings” button to preserve your chosen settings and options.


This plugin may cause catastrophic failure of your website, especially where images and templates are concerned. Contacting the company themselves has revealed they are fully aware of significant incompatibility issues with WordPress, other established main stream plugins and several common and widely used Themes. It has been recommended to the company and to WordPress that this plugin be withdrawn immediately until the developer has corrected these issues.


what3words Autosuggest Plugin はオープンソースソフトウェアです。以下の人々がこのプラグインに貢献しています。


“what3words Autosuggest Plugin” をあなたの言語に翻訳しましょう。

開発に興味がありますか ?

コードを閲覧するか、SVN リポジトリをチェックするか、開発ログRSS で購読してみてください。


The current version is 3.0.10 (2021.03.09)


  • Released 2021.03.09
  • Fixes passing API key to autosuggest for requests.


  • Released 2021.02.03
  • Updated screenshots
  • Send key version numbers to what3words API via X-W3W-Plugin request header.


  • Released 2020.12.11
  • Improved interoperability, errors in 3rd party scripts will be less likely to prevent the plugin operating.
  • Bumped to latest WordPress release, 5.6


  • Released 2020.06.17
  • Addresses an error that prevented the plugin loading on Internet Explorer.
  • Minor styling improvements.


  • Released 2020.06.02
  • Further improvements to match theme styling
  • Clarified the purpose of the Input Selector(s) field
  • Updated readme


  • Released 2020.06.01
  • Apply missing font-size property.


  • Released 2020.06.01
  • Hotfix missing font-size property.


  • Released 2020.06.01
  • Plugin tweaked to take up less vertical height on themes with slimmer text inputs.


  • Released 2020.06.01
  • The plugin now inherits styles from the current wordpress theme for more seamless integration.
  • The following css properties are automatically applied to the upgraded input: background-color, border, border-radius, color, font, height.


  • Released 2020.05.27
  • Fixes an issue where country clipping would not work when shipping and billing addresses were in different countries.
  • Updated screenshots


  • Released 2020.05.26
  • Updated the plugin to use new web component and V3 of the what3words API. Note that this release simplifies the plugin setup and removes some settings.
  • Updated links to what3words documentation and developer site
  • Settings available are now:
  • API key
  • CSS selector to specify which inputs should be upgraded to the auto suggest component
  • Placeholder text shown on inputs
  • Turn on/off the WooCommerce integration, to automatically add what3words address fields to your checkout forms


  • Released 2019.01.16
  • Added new function to allow a country field to be specified for country clipping


  • Released 2018.04.05
  • bug fixes


  • Released 2018.03.16
  • bug fixes


  • Released 2018.01.09
  • bug fixes


  • Released 2018.01.08
  • Reworked and redesigned plugin code base


  • uses what3words autosuggest jQuery plugin 1.2.0


  • General fixes


  • Initial release