Addresses

Address Lookup

Overview

The HMRC address lookup microservice is used to request a user's home or business address. This can be used with UK addresses as well as international addresses.

Many different services across HMRC use address lookup and there is lots of variation in journey, style and content. HMRC address design guidance could keep the address lookup service consistent for the user and ensure all services follow the same proven template.

This pattern is planned to be supplementary to the existing GDS Addresses guidance.

Some considerations

accurately collect a users address in a few simple steps
provide a secondary method of collecting addresses for international users
collect all information required for a service
provide the opportunity for users to go back a page and/or change their information
auto-populate users inputted information when going back a page or editing their details
opportunity to navigate using keyboard inputs e.g. using Enter to ‘continue’
is accessible for those with screen readers - using ‘aria-hidden’ where needed and providing sufficient hidden text to guide users through the process
error messages
components and styles follow HMRC/GDS guidance
allow users to review and confirm the information they provide and make edits where appropriate

Examples of other services using address lookup

Search for land and property information
Soft drinks industry levy
Apply for a passport
Self assessment
Set up a limited company: step by step
Set up a private limited company
Tell HMRC about Capital Gains Tax on UK property or land if you’re not a UK resident
Tell HMRC about a change in personal details