what3words Autosuggest Plugin


This plugin allows you to add searching for, capturing and validating a 3 word address from a form on your WordPress powered site.


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 css selector (.class, #id) to the plugin’s Input Selector(s) configuration option as described below.

what3words API settings

A what3words API key is required to use this plugin as it authenticates and interacts with the what3words RESTful API

If you don’t have a what3words API key yet, you can quickly and easily sign-up and register for one.

General Settings

  • Input Selector(s) – the input fields that the plugin is configured to search for 3 word addresses. These should be specified as a comma
    separated list of css selectors.

  • Input Placeholder Text – an optional placeholder to be displayed in the input fields that are configured in the Input Selector(s) option.

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 automagically added to the list of Input Selector(s).

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.


Applied to the default set of plugin settings and options. Note that this filter is called once, upon plugin activation, when there are no what3words AutoSuggest plugin settings/options existing in the database.

Example: Add the date and time that the plugin was first activated

add_filter ('what3wordssearchbox_default_settings', 'add_activation_timestamp');

function add_activation_timestamp ($options) {
    // options = array (option name => option value)
    $options['plugin_activation_timestamp'] = date (DATE_ATOM);

    return $options;


  • Plugin settings
  • The plugin at work, showing a searchbox


  1. 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.
  2. Or you can install what3words AutoSuggest plugin manually. Download the plugin Zip archive and uncompress it. Copy or upload the what3words-searchbox folder to the wp-content/plugins folder on your web server.
  3. Activate the plugin. From the Dashboard, navigate to Plugins and click on the “Activate” link under the entry for What3words Searchbox.
  4. 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.
  5. Click on the “Save what3words AutoSuggest plugin Settings” button to preserve your chosen settings and options.



what3words provides a precise and incredibly simple way to talk about location. We have divided the world into a grid of 3m x 3m squares and assigned each one a unique 3 word address. For more information check out the what3words web site.

How do I get help or support for this plugin?

You can ask a question on the WordPress support forum so that other users can follow the conversation. You can ask a question on Twitter; we’re @what3words. Or you can drop us an email instead.

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 and hand-holding.

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.


Read all 1 review

Contributors & Developers

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



The current version is 3.0.1 (2020.05.27)


  • Released 2020.05.27
  • Fixes an issue where country clipping would not work when shipping and billing addresses where 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 show on inputs
  • Input language
  • 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