About this plugin
Shoppers start typing their address, pick it from a list, and the rest of the address form fills in — street, unit or floor and door, suburb or town, state and postcode. Fewer typos, fewer failed deliveries.
- Australia — every address in G-NAF, the Geocoded National Address File, from getaddress.io.
- Denmark — every address in DAR, Danmarks Adresseregister, from getaddress.dk.
- New Zealand — every address in LINZ’s NZ Addresses, from getaddress.nz. Postcodes are unofficial (not NZ Post’s).
The plugin plugs into WooCommerce’s own address autocomplete, so it works on the block checkout and the classic [woocommerce_checkout] checkout, on billing and shipping addresses, with WooCommerce’s own look.
- Missing unit numbers caught. G-NAF knows which buildings have units. Pick an Australian building with units and the plugin opens the apartment line and asks for the unit number — something Google-based autocomplete can’t tell you. Danish suggestions already list each flat with its floor and door, and New Zealand ones each unit (2/12 East Street), so there is nothing to ask.
- Every order checked. With your API key saved, each new order’s delivery address is checked in the background — Australian addresses against G-NAF, Danish ones against DAR, New Zealand ones against LINZ. Addresses that don’t exist, buildings missing a unit number (or, in Denmark, a floor and door), and PO Boxes get a private order note, and the Orders list shows a column with the result — so you catch them before you ship.
- Saved addresses too. Customers editing their billing or shipping address in My Account get the same suggestions as at checkout, in Australia, Denmark and New Zealand, with the unit prompt and PO Box handling.
- Business names in the Company field. Typing in the Company field suggests registered business names — Australian ones from the Australian Business Register with their ABN, state and postcode, Danish ones from CVR with their CVR number, postnummer and town — so the name on the order is spelled the way it is registered. Free: picking a name makes no look-up. Not yet in New Zealand.
- PO Boxes handled. Typing a PO Box, GPO Box, Locked Bag or parcel locker (Australia), a Postboks, pakkeboks, parcel shop or Døgnpost (Denmark), or a PO Box, Private Bag, CMB or parcel locker (New Zealand), shows no misleading street suggestions, and you can choose to refuse them as a delivery address (checked on your server, on both checkouts).
Suggestions only appear for a country you have a token for. Other countries’ address forms are left exactly as they are.
What you need
- WooCommerce 9.9 or later.
- A getAddress() account for each country you sell to ( getaddress.io for Australia, getaddress.dk for Denmark, getaddress.nz for New Zealand), and a domain token for your shop’s domain (created in your account under Domain tokens). A domain token only works on the domain it was made for, so it is safe in a web page — never paste an API key there. The countries are separate services: a getaddress.io token or key works only in Australia, a getaddress.dk one only in Denmark, a getaddress.nz one only in New Zealand.
External services
This plugin sends what a shopper types into the checkout address field, and the id of the address they pick, from the shopper’s browser to getAddress():
- Australian addresses: https://api.getaddress.io — terms, privacy.
- Danish addresses: https://api.getaddress.dk — terms, privacy.
- New Zealand addresses: https://api.getaddress.nz — terms, privacy.
A request is only made when the shopper has chosen a country you have entered a token for, and has typed at least three characters.
dk/companies (Denmark). New Zealand has none, so nothing is sent for it. Switch them off in the plugin’s settings.
nz ) for the domain token and API key; Disconnect posts to its /connect/revoke. Nothing about shoppers is sent.
nz/validate. Only for a country you saved a key for; without one, nothing is sent from your server. No name, email, phone number or order details are sent.