This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

what3words Address Field


The what3words Address Field 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 Address Field 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 your customers to easily enter and validate a what3words address in a form on your WordPress powered site, most likely your checkout page if using WooCommerce.

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.


You will 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.

Once you have a what3words API key:

  1. Click the what3words menu item on your wp-admin page.
  2. Enter your API Key into the API key field.
  3. Click Save

General Settings


The general settings allow you to customise how the what3words Address Field is configured on your site.

For WooCommerce users the plugin can automatically add an address field for both billing and shipping information, allowing your customer to specify a three word address for both billing and/or shipping address to help you locate your customers with ease. By default this option is selected and if you have configured your WooCommerce plugin it will automatically add these fields for you on your checkout page. Or you can select the Add what3words Address Field to my checkout page for me option.

Custom Fields

Alternatively you can customise which field(s) to convert to a what3words Address Field by selecting Convert an existing field to a what3words Address Field option and providing selectors for the inputs to convert. You can use any DOM compliant query selector(s) here to specify a single or multiple fields that you wish to convert.

N.B. When using input selectors you should ensure each input field has a unique name attribute to ensure clashes do not occur if multiple what3words Address Fields appear on a single page.

If you want to add a new custom field to extend as a what3words Address Field you should first create an input field on the page you wish to add this functionality to and provide with a name, id and/or that can then use in the input selector to specify it. (Be careful when using classes as it can apply this behaviour to multiple fields.)

If you want to capture the selected what3words address you should wrap this field in a form with a submit button and this will then be submitted as specified by your form.

Save coordinates

If you need to capture the coordinates for a three word address to help with delivery information, for example, you should check the Save coordinates checkbox with will also retrieve the coordinates for the captured three word address.

If you have added the what3words Address Field to your WooCommerce checkout and you select Save coordinates the coordinates for the billing and shipping address fields will added to your order and visible in your Orders page on WooCommerce.

If you are using custom field(s) for the address then you the component will automatically attach hidden fields for both the latitude and longitude of the coordinates for the adddress prefixed with the name you supplied to the input field.


For improved accessibility it is recommended that you add a label to your what3words Address Field. By checking this option and supplying some text for the label you can easily associate a label to each of your address field(s).

For WooCommerce customers this option allows you to override the default label associated to the address field(s), while for custom field users this option tells the plugin to create a label field for you.

Advanced Features

Custom placeholder

You can override the default placeholder for the address field(s) by selecting this option and specifying the placeholder text. We recommed you use the default placeholder value as it provides your customers with an example of how to use the what3words Address Field.


We provide a number of options for clipping the autosuggest results. You can clip suggestions to a number of countries by providing comma separated 2 digit ISO codes for each country you wish to clip to. This will ensure suggestions provided are clipped within the countries specified. You can also clip within a circle, a bounding box or a polygon.

N.B. – When providing multiple clippings the intersection of each is what forms the suggestions provided when using the what3words Address Field.

For WooCommerce checkouts we recommend skipping these options as the clip to country is automatically set when a user selects a country for their billing and/or shipping information as they select a country from the dropdown menu options in the checkout form.


  • Accept what3words addresses on your checkout page, or in a custom field.
  • Display autosuggest results with geolocations to reduce user error
  • Customize the autosuggest results with advanced features


WordPress Installation (recommended)

You can install the what3words Address Field plugin through the WordPress plugins page in your WordPress admin panel.

  1. Navigate to the Plugins > Add New page
  2. Search for “what3words”
  3. Click the Install Now button.
  4. Once installed, you can activate the plugin on the Plugins page.

Manual Installation

You can download the what3words Address Field plugin from the WordPress Plugins site.

  1. Download the what3words Address Field plugin from the WordPress Plugins site
  2. Once you have downloaded the zipped plugin, you can upload it to your WordPress installation by navigating to Plugins > Add New, click the Upload Plugin button
  3. Select the zipped plugin file and click Install Now
  4. Once installed, you can activate the plugin on the Plugins page.



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.

More about what3words

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

Find our full developer documentation here:

You can learn more about our privacy policy here:

Get in touch with us

Have any questions? Want to learn more about how the what3words Address Field plugin works? Get in touch with us at


Hunyo 15, 2022
Super easy to install and setup. It's integrates well into the Checkout page and also within the Admin > Order view. A must for all eCommerce stores.
Nobyembre 25, 2020 3 replies
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.
Read all 4 reviews

Contributors & Developers

“what3words Address Field” is open source software. The following people have contributed to this plugin.




  • Released 2023.10.04
  • Fixed a bug that did not populate clip to country correctly with certain themes


  • Released 2023.10.02
  • Patched a security vulnerability that captured all $_POST values and stored them in the DB
  • Fixed a bug that did not allow clip to country to be deselected


  • Released 2023.05.15
  • Fixed a bug that displays null when input selector used and save nearest place is not selected
  • Display what3words address on order emails


  • Released 2023.01.04
  • Autosuggest not being rendered correctly on certain checkout pages
  • Fixed a bug where the autosuggest web-component was not being mounted correctly
  • JS script now uses native javascript selectors instead of JQuery


  • Released 2022.05.31
  • Fixed critical error which surfaced when WooCommerce plugin is not installed


  • Released 2022.05.03
  • Update to improve integration on checkout page with Fluid Checkout and other plugins.
  • Bump autosuggest component library version to v4.0.6


  • Released 2022.04.21
  • Fix bug where metadata wasn’t sent to WooCommerce if applying autosuggest to an existing field.


  • Released 2022.03.25
  • Security vulnerability fixed for get_option exposing sensitive information.
  • Loading the w3w autosuggest script asynchronously


  • Released 2021.07.20
  • Upgraded to use V4 of the what3words AutoSuggest Component with improved styling and functionality.
  • Updated admin section interface.
  • Addition of advanced clipping options to restrict suggestions displayed to a user.
  • Addition of options to store latitude and longitude coordinates and nearest place against a record.
  • Added ability to change the field label.


  • Released 2021.06.30
  • Fixes non-fatal debugging log output for PHP “Variable assignment” error


  • 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