# Forminator

Add address autocompletion and postcode lookup to your Forminator pages.

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

#### Address Finder Demo[​](#address-finder-demo "Direct link to Address Finder Demo")

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

#### Postcode Lookup Demo[​](#postcode-lookup-demo "Direct link to Postcode Lookup Demo")

![Quickly populate your address fields-screenshot](/assets/images/forminator-pl-demo-0481ecc1de23d18df90348164047ae75.gif)

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

This integration works by adding our Address Validation tools using Forminator's form editor. Below are the instructions to add Postcode Lookup or Address Finder.

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 UK address should have the following fields:

* Address line one (required)
* Address line two
* Address line three
* Post town (required)
* Postcode (required)

![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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)

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

### 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 initialise it.

![Initialise Address Finder](/assets/images/forminator-af-install-fbb955b241b5d8ef3287d0c1ad8d5c5d.png)

```
<script src="https://cdn.jsdelivr.net/npm/@ideal-postcodes/address-finder-bundled"></script>



<script>

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

		IdealPostcodes.AddressFinder.setup({

			apiKey: "ak_test",

			outputFields: {

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

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

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

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

				postcode: '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 Address 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/paf.md). For instance, adding a county field with name `county` will look like:

```
outputFields: {

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

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

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

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

  postcode: 'input[name="text-5"]'

  uprn: 'input["name-text-6"]'

}
```

***

### Add Postcode Lookup[​](#add-postcode-lookup "Direct link to Add Postcode Lookup")

#### Add Postcode Lookup HTML elements[​](#add-postcode-lookup-html-elements "Direct link to Add Postcode Lookup HTML elements")

In your form builder, insert a new field. Choose HTML and make sure you place it above the first input field of your address form. Copy and paste the HTML code below.

![Fluent Form Postcode Lookup setup](/assets/images/forminator-html-e487b2e3a187743db75281c991ebaec3.png)

```
<div id="idpc"></div>
```

Next, go to your page and create an html block at the bottom of the form and add the script below.

![Enter script into the code editor-screenshot](/assets/images/forminator-pl-install-74f0d5bc3afa4607d5aa1b0ebb154bcc.png)

```
<script src="https://cdn.jsdelivr.net/npm/@ideal-postcodes/postcode-lookup-bundled"></script>



<script>

	IdealPostcodes.PostcodeLookup.setup({

		apiKey: "ak_test",

		context: "#idpc",

		outputFields: {

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

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

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

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

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

		},

	});

</script>
```

If you wish to add an additional field, choose a parameter [from our UK Address data guide](/docs/data/paf.md). For instance, adding a county field with name `county` will look like:

```
outputFields: {

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

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

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

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

  postcode: 'input[name="text-5"]'

  uprn: 'input["name-text-6"]'

}
```

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

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

See our [Postcode Lookup Plugin Documentation](/docs/postcode-lookup.md) if you wish to customise Postcode Lookup.

info

Still need help? Contact our support team via live chat on our website or email <support@ideal-postcodes.co.uk>.
