# Gate Population by Delivery Area

## Overview[​](#overview "Direct link to Overview")

`shouldAddressPopulate` runs after an address is retrieved and **before** it is written to the form. Return `false` to cancel population, or `true` to proceed. Use it to block addresses you can't serve - outside a delivery area, an unsupported country, or any custom rule - before the fields are filled in.

The predicate may be synchronous or return a promise, so you can call your own API to make the decision.

## Cancel synchronously[​](#cancel-synchronously "Direct link to Cancel synchronously")

Return `false` from a plain function to block population. Here we only accept London (`E`, `EC`, `N`, `NW`, `SE`, `SW`, `W`, `WC`) postcodes:

```
import { AddressFinder } from "@ideal-postcodes/address-finder";



const LONDON = /^(EC|WC|E|N|NW|SE|SW|W)/i;



AddressFinder.setup({

  apiKey: "ak_test",

  outputFields: {

    line_1: "#line_1",

    line_2: "#line_2",

    post_town: "#post_town",

    postcode: "#postcode",

  },

  shouldAddressPopulate: function (address) {

    const ok = LONDON.test(address.postcode);

    if (!ok) this.setMessage("Sorry, we only deliver within London");

    return ok;

  },

});
```

## Check asynchronously[​](#check-asynchronously "Direct link to Check asynchronously")

Return a promise to defer to your own API. **Errors are your responsibility**: a rejecting promise **fails open** (population proceeds) rather than blocking the user on a broken check. Catch inside the predicate and return an explicit boolean - `return false` to cancel, `return true` to allow:

```
shouldAddressPopulate: async function (address) {

  try {

    const res = await fetch(`/api/delivery-area?postcode=${address.postcode}`);

    const { deliverable } = await res.json();

    if (!deliverable) this.setMessage("Sorry, we don't deliver to this address");

    return deliverable;

  } catch (err) {

    reportError(err);   // your telemetry - the widget will not surface this

    return true;        // fail open: don't block the customer on an outage

    // return false;    // ...or fail closed to be strict

  }

}
```

## Reacting to the decision[​](#reacting-to-the-decision "Direct link to Reacting to the decision")

* **To show a message on cancel**, do it inside the predicate before `return false` (as above).
* **To confirm population actually happened** - for example to gate a form submit - use the [`onAddressPopulated`](/docs/address-finder/callbacks.md) callback. It fires only when population proceeds, so a cancelled selection never trips it.

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

Search for an address. Non-London postcodes are declined and the fields stay empty.

Loading...

```
<form style="max-width: 450px; padding: 10px;">
  <label for="line_1">Address First Line</label>
  <input type="text" id="line_1" />
  <label for="line_2">Address Second Line</label>
  <input type="text" id="line_2" />
  <label for="post_town">Town or City</label>
  <input type="text" id="post_town" />
  <label for="postcode">Postcode</label>
  <input type="text" id="postcode" />
</form>
```

```

import { AddressFinder } from "@ideal-postcodes/address-finder";

const LONDON = /^(EC|WC|E|N|NW|SE|SW|W)/i;

AddressFinder.setup({
  apiKey: "ak_test",
  outputFields: {
    line_1: "#line_1",
    line_2: "#line_2",
    post_town: "#post_town",
    postcode: "#postcode",
  },
  shouldAddressPopulate: function (address) {
    const ok = LONDON.test(address.postcode);
    if (!ok) this.setMessage("Sorry, we only deliver within London");
    return ok;
  },
});
```