Changelog

Add UK address autocomplete to a React app in a single component. The new @ideal-postcodes/react package gives you a drop-in <AddressFinder> with no useEffect or useRef wiring to manage. Install with npm install @ideal-postcodes/react.

Details

• Drop-in component: Render <AddressFinder> and start searching. The widget lifecycle is handled for you, with no manual setup or teardown
• Bring your own input: Let the component render its own field, or wrap an input you already have. It works alongside design systems such as shadcn/ui, MUI, and Mantine
• Every callback as a prop: Each widget event is exposed directly, including onAddressRetrieved. Inline handlers always see your latest state, so there is no need to reach for useCallback
• Styling that fits your build: CSS is injected automatically, or import it yourself for full control under server-side rendering
• Framework ready: Tested with the Next.js App Router ("use client") and Pages Router, Remix, and Astro, on both React 18 and 19

Read the React integration guide to get started. The latest Address Finder (5.2.15) and Postcode Lookup (3.3.2) widget bundles also ship in this release.

Cleanse, verify, and enrich UK addresses without leaving Excel. The new Address Cleanse add-in matches your addresses against the Royal Mail Postcode Address File: drag-select the address column, click Cleanse, and corrected addresses with UPRNs and geocodes are written alongside your data. No exports, no code.

Details

• Cleanse in place: Select one column of freeform addresses, or two columns with a postcode hint, and results are written immediately to the right
• 31 columns per row: Status, formatted address, confidence and fit scores, per-element match levels, geocodes, UPRN, UDPRN, and country data
• Static values: Results persist in the workbook, so it can be shared and reopened by anyone without the add-in or an API key
• All Microsoft 365 platforms: Works in Excel for Windows, Excel for Mac, and Excel for the web
• Key kept private: Your API key is held in Office storage, never in cells or files

Follow the install guide to get started; an AppSource listing is on its way.

Introducing idpc, the Ideal Postcodes command line interface. Manage your account, clean address data, and validate emails and phone numbers from the terminal. Built for humans and agents.

In agent mode, the CLI will non-interactively emit JSON to stdout and signal failure through exit codes.

Details

• Key management: Check balances, usage, lookup logs, and allowed-URL configurations for your API keys
• Address cleansing: idpc cleanse matches messy addresses against authoritative data, taking a single query, a file, or stdin, with CSV output for batches
• Find and resolve: idpc find returns address suggestions for a partial query; pipe a suggestion ID into idpc resolve for the full record
• Email and phone validation: idpc email and idpc phone mirror the cleanse workflow, with --carrier lookups for phone numbers
• Diagnostics: idpc doctor verifies connectivity and reports whether your key is actually usable, explaining limits or restrictions when it is not

Install with npm install -g @ideal-postcodes/cli. Available on npm.

Postcodes.io 19 is out, adding Senedd Cymru constituency fields, a far richer Scottish Postcode Directory, and faster bulk lookups.

Details

• Welsh Parliament data: Postcode lookups now return official Senedd Cymru constituency fields, with schemas and documentation updated to match
• Expanded Scottish coverage: The Scottish Postcode Directory endpoint grows from three fields to over 50 distinct data fields and 20+ administrative codes, including the Scottish Index of Multiple Deprivation, data zones (2001 and 2011), and historical Census Output Areas (1991, 2001, 2011)
• Simpler data layer: The database is flattened and denormalised into three master tables: onspd, spd, and osopennames
• Faster bulk operations: Bulk postcode and reverse-geocoding requests are batched into single SQL queries, with Postgres tuned for read-only workloads using pg_prewarm and partial indexes

Reseller organisations now have a dedicated dashboard that summarises their licensees, active client count, and usage costs for any billing period. Track the accounts you manage and reconcile usage without exporting raw logs by hand.

Details

• Account overview: See your licensees, active client count, and usage costs at a glance for the selected period
• Customer breakdown: A per-licensee table shows each client's address and API key, with sortable numeric columns and CSV export
• Period picker and deep-links: Choose any billing period and jump straight to a licensee's keys and dates

Integrate Ideal Postcodes from inside your AI coding agent. The new ideal-postcodes/skills plugin teaches Claude Code, Cursor, and Codex how to wire up our widgets, API, and CLI correctly the first time. Install with npx skills add ideal-postcodes/skills.

Details

• Address Finder: Set up the autocomplete widget (@ideal-postcodes/address-finder), from install to populated form fields
• Postcode Lookup: Postcode in, address dropdown out (@ideal-postcodes/postcode-lookup)
• API integration: Authentication, /postcodes, /addresses, /udprn, and /autocomplete, client libraries, and error handling
• CLI: Manage keys, cleanse addresses, and resolve partial queries from the terminal with the idpc CLI
• Built for agents: Each skill carries quickstarts, critical gotchas, and reference material, cutting the back-and-forth of getting a working integration

The repo is public; issues and pull requests are welcome.

Ideal Postcodes is now the address validation provider built into Microsoft Dynamics 365 Business Central. From Release 28, the extension ships by default to all UK and Republic of Ireland Business Central users, replacing the discontinued getAddress.io service.

Details

• Native postcode lookup: Fast UK postcode search inside the existing Business Central interface, with fuzzy matching for unrecognised postcodes
• Automatic field population: Selected addresses fill the address fields in the correct format across customer records, quotes, and orders
• Royal Mail PAF data: Backed by the Postcode Address File, covering over 30 million delivery points and 1.8 million postcodes
• Simple activation: Add your Ideal Postcodes API key in Business Central's Service Connections settings; no additional software required
• Rollout window: New customers receive version 28.0 automatically; existing customers can schedule the update any time before 31 August 2026

See Microsoft's setup guide to get started.

WooCommerce 4 is the new major release of our WooCommerce plugin, adding support for the block-based checkout. The postcode lookup is rebuilt as an isolated web component so it no longer interferes with checkout form validation. Requires WooCommerce 8 or above; legacy shortcode checkout is no longer supported.

Details

• Block checkout: Postcode Lookup and Address Autocomplete work natively in the block-based checkout
• Isolated web component: The rebuilt postcode lookup no longer blocks order submission by clashing with form validation
• Country-aware validation: A new toggle switches off address validation automatically when the customer selects an unsupported country
• Dedicated Address Finder field: Optionally render the address search in its own field
• JSON configuration overrides: Fine-tune Postcode Lookup and Address Autocomplete behaviour directly from the Advanced settings tab
• Validation controls: Address line one character limit (default 40), transliteration of accented characters to ASCII, ASCII-only input, automatic company name population, and PO Box blocking

Find the settings under WooCommerce > Settings > Integration > UK Address Postcode Validation. Full setup in the WooCommerce integration docs.

Postcode lookup is now available for Singapore, Ireland (HERE) and the Netherlands. Resolve a postcode to its set of addresses in three more markets without falling back to an autocomplete flow.

Details

• Singapore: Postcode-to-address resolution across the SGP dataset
• Ireland: Eircode-style postcode lookups against the HERE Ireland dataset
• Netherlands: Postcode lookup over Dutch address data