# Forminator

Add address autocompletion and postcode lookup to your Forminator pages.

## Demo[​](#demo "Direct link to Demo")

![Activate Address Finder on your address collection forms-screenshot](/assets/images/forminator-al-demo-548f967d4782d204daf31839df6c607d.gif)

## Installation[​](#installation "Direct link to Installation")

### Form Creation[​](#form-creation "Direct link to Form Creation")

This integration works by adding our Address Verification tools using Forminator's form editor.

Add address input fields to your form. To do so, click 'insert fields' and select `input`. Once clicked, you can update the label text.

A basic address form to capture a correct US address should have the following fields:

* Street Line One
* Street Line Two
* City
* State
* Zip Code

![Create address fields-screenshot](/assets/images/forminator-create-form-cedc66d221d1b89c5bb4ba23019642bc.png)

You can optionally include additional fields, which are listed in the [Address data guide](/docs/data/paf.md).

info

Make a note of the name generated for your input field.

![Forminator input name](data:image/png;base64,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TKE9N954ozRr1kx++OEH/XDfp08fqVKlimqaoUOHyqxZs5T3LbfcohqJg4Qc0V+wQktdccUVmgwPcPnggw+0P++++66MGTNGbr/9dhk7dqzypi/XX3+9lkcA/TBwzygO1/96XBxaU0LbMHnyZLn88svltttu09OoGCCOJk2apAPmuuuu0zJfffWVy5KgvF27dsmiRYt0sDJA161bJ7169ZIKFSro4Pvjjz9iGuSdd96Rjz76SJ588klp1aqVvPjii1r3t99+k379+smpp54qQ4YMkY0bN8qzzz4be35Rbn7++WehLRDmKX294YYbpHPnziro06dP1zw0Df1GAG6++WbVRN6+Uui7775TXxIh8tLFF18smIVr1qwR2rxp0yZZtWqV9O7dW0/1wgRFmwZh4OWX63vTVBm+AQYKnzvvvFO1RJMmTXTg4V9B8+fPV63C4IYY2G+88YbeB+VRAGHATOKUK36dGXgPPfSQVKpUSe8HDBigWmrt2rVahnKdOnWSSy+9VE444QTVmAxS0s844wzVZmg/AhJeDaKNKeKfm266SW699VYtPXHiRFm8eLG0bdtWBapdu3Zy7bXXat60adPUJL7oootinLdt26b3tWrViqVxc9ppp+l3NLyjJ554QvtZeC6l/lisX79eEOBEGBx//PGuas6vJlQZvgLnQ2Givf3222qu/fjjj+o3XHDBBbJy5Uo1d9xjGOCOgvIoc+yxx6pAcI/J9+effwqD2kvLly+Xvn376sDD/KxcubJqkgcffFBN0EcffVRef/11waxq2LChBgXSFSie621/+fLldZCjQRjs+F98HJHvpdq1a+vX1atXq9Z2efwoQeRjpkKujY4HpmMQBpiRxYVMqDJ4E4TPMbsYyPgKjvCDEDaEqn79+qqdXJ73GpTnLcc9mocj5PCteB6ESVSuXDnZsGGDDBw4UNNoD6ZexYoVpWPHjnLJJZdI+/btBVNs2LBh0rNnT1m4cKEKrFYI4c+JJ56oXNCS8EfwaFv86Vxnn322niu5dOlS6datW+zJREPRNKeffnosze8mCAO/8rlKM58qA+SJ+BH5wwybOnVq7IMj/umnn2pQAoccjYTTzeAh3VFQnivjrvgxaIMXXnhBhYj5IzQU2uvhhx/WoACmHtqIE4YJWHz55ZeCP4aZholFwMEJpOPrvX722WcCX/f59ddfvdkJ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)

### Add Address Finder[​](#add-address-finder "Direct link to Add Address Finder")

On the WordPress admin dashboard, click on the 'Pages' tab, followed by 'Add New'. Now, click on the 'shortcode'and paste your Forminator shortcode in. Next click on 'Add block' icon and look for the 'Custom HTML' component. Add the following two script tags within the HTML block to load the plugin and then to initialize it.

![initialize Address Lookup](/assets/images/forminator-al-install-b2ee85bb9e61cdf294a091b6cb38398e.png)

```
<script 

src="https://cdn.jsdelivr.net/npm/@addresszen/address-lookup"></script>



<script>

  document.addEventListener("DOMContentLoaded", function () {

    AddressZen.AddressLookup.setup({

      apiKey: 'API_KEY_HERE',

      outputFields: {

        line_1: 'input[name="text-1"]',

        line_2: 'input[name="text-2"]',

        city: 'input[name="text-3"]',

        state: 'input[name="text-4"]',

        zip_plus_4_code: 'input[name="text-5"]',

      }

    });

  });

</script>
```

caution

Take special care to:

1. Insert your API Key in the `apiKey` field
2. Match the names of your address fields. If your Street Line One has name = `text-1`, ensure that `line_1` reads `'input[name="text-1"]'`

If you wish to add an additional field, include the parameter name [from our documentation](/docs/data/usps.md). For instance, adding a country field with name `country` will look like:

```
outputFields: {

        line_1: 'input[name="text-1"]',

        line_2: 'input[name="text-2"]',

        city: 'input[name="text-3"]',

        state: 'input[name="text-4"]',

        zip_plus_4_code: 'input[name="text-5"]',

        country: 'input[name="text-6"]'

}
```

## Configuration[​](#configuration "Direct link to Configuration")

See our [Address Lookup Plugin Documentation](/docs/address-lookup.md) if you wish to customize Address Finder.

info

If you need support, you can reach out to us on our [support page](https://addresszen.com/support).