Add Australian Address Autocomplete to Any Form in One Script Tag

A clean, correct address is the difference between a delivery that arrives and one that doesn't. The reliable way to get one is to stop asking people to type it in full, and suggest it as they go. WattleAddr ships a drop-in widget that adds Australian address autocomplete to any form. No framework, no build step, and no customer keystrokes sent offshore. This is the entire integration:

<script src="https://api.wattleaddr.com.au/v1/widget.js"></script>
<script>
  var wa = new WattleAddr('waddr_pk_live_xxxxx');
  wa.attach('#address', {
    onSelect: function (address) {
      // address.formatted, plus structured components
      document.querySelector('#address').value = address.formatted;
    }
  });
</script>

That is it. Point it at an existing <input>, and it starts suggesting real Australian addresses after a few characters.

How it fits together

• Publishable key, locked to your domains. The key in the browser is a publishable key (waddr_pk_…) that you restrict to your own domains in the console. Your secret key stays on your backend and never appears in client code.
• Fast on every keystroke. Requests are simple GETs with the key in the query string, so there is no CORS preflight slowing down each character your customer types.
• Structured results, not just a string. The onSelect callback hands you the formatted address plus its components, so you can spread suburb, state and postcode straight into your own fields.
• No dependencies. One script, no bundler, works in a plain HTML form or inside any framework.

One pro tip for durable data

When you capture an address, store the returned components and formatted string, not only an identifier. Australian address identifiers can change between the quarterly data releases, so persisting the actual address values keeps your records stable over time.

Get started

Grab a publishable key and drop the widget in from console.wattleaddr.com.au, or read more at wattleaddr.com.au.