shipperhq / module-address-autocomplete
shipperhq/module-address-autocomplete
ShipperHQ Address Autocomplete Tool
ShipperHQ Address Auto-Complete
The ShipperHQ Address Auto-Complete extension enhances Magento 2 stores by integrating Google's Address Auto-Complete API. This extension simplifies the checkout process by enabling address lookup functionality, improving user experience, and reducing address entry errors.
You do not need a ShipperHQ account to use this extension. More information on ShipperHQ capabilities is available at ShipperHQ.
Features
- Seamless Address Auto-Complete: Instantly suggest addresses as customers type.
- Guest & Logged-In Customer Support:
- Auto-complete available for guest checkout shipping addresses.
- Auto-complete for logged-in users adding a new address to their address book.
- Supports new shipping address entry at checkout.
- Google API Integration: Requires a Google API key with access to the Google Places API Web Service.
Requirements
- Magento 2.4.4+
- Compatibility with earlier editions is possible but not maintained
- Supports both Magento Opensource (Community) and Magento Commerce (Enterprise)
Installation
Install using Composer by running the following commands:
composer require shipperhq/module-address-autocomplete
composer update
php bin/magento setup:upgrade
We recommend installing the ShipperHQ Logging module for enhanced debugging:
composer require shipperhq/module-logger
composer update
php bin/magento setup:upgrade
Configuration
- Navigate to
Stores > Configuration > Sales > Shipping Settings. - Open the ShipperHQ Address Auto-Complete tab and enable the extension.
- Enter your Google API Key. If you do not have one, register and ensure you have enabled the Google Places API Web Service on your Google account.
- Save the configuration.
- Refresh the Magento cache from
System > Cache Management.
For further setup details, visit our configuration guide.
Limitations
- Address auto-complete is not supported on any admin forms.
- Address auto-complete is not available for billing addresses.
Support
As a free extension, ShipperHQ Address Auto-Complete is provided as-is without support.
Contribution
Any contribution is highly appreciated. The best way to contribute code is to open a pull request on GitHub.
License
See license files.
Copyright
Copyright (c) 2015 Zowta LLC (ShipperHQ)
Change Log
All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning(http://semver.org/).
1.0.0
Initial Release
1.0.1
SHQ16-2072 address autocomplete changes
1.0.2
SHQ16-2072 address autocomplete changes
1.0.3
SHQ16-2112 support for address elements specific to New York, UK and Sweden
1.0.4
SHQ16-2150 handle no API key, increase z-index and handle apartment number
1.0.5
SHQ16-2150 handle no API key, increase z-index and handle apartment number. Also changed tagged version number
20.0.5
SHQ16-2150 handle no API key, increase z-index and handle apartment number. Also changed tagged version number
20.0.6
SHQ16-2244 add polyfill for IE 11 issue
20.1.0
SHQ16-2328 moved css for autocomplete to less file
20.1.1
M2-56 code sniffer changes
20.1.2
Updated README with grammar corrections
20.1.3
SHQ18-65 - handle Google API authentication errors
20.2.1 (2018-07-27)
SHQ18-260 Disable Google Chrome autofill if address lookup is enabled
20.3.0 (2018-12-18)
Added a setting to use extended postcodes when available
20.3.1 (2020-06-18)
MNB-401 Fix issue with popup rendering for logged in users
20.3.2 (2020-12-21)
MNB-532 Fix use long zip option
20.3.3 (2021-04-01)
MNB-1058 Fix conditionals and fix issue with whole address printing in street line 1
20.4.0 (2021-06-01)
RIV-534 support Enhanced Checkout
20.5.0 (2021-11-30)
MNB-1843 User submitted enhancement to refactor add new address UI. MNB-1789 Fix for street address becoming uneditable on Google API error
20.5.1 (2022-01-17)
MNB-1966 Fix for Quebec not populating and added CSP whitelist
20.6.0 (2022-01-24)
MNB-574 Add support for placing house number after street name
20.6.1 (2022-05-24)
MNB-2364 Resolve issue with Montreal not being populated as city
20.6.2 (2023-04-13)
SHQ23-326 Fix issue with formatting of US addresses containing an apartment or suite number
20.6.3 (2024-06-03)
SHQ23-2640 Remove trailing comma from stress address
20.6.4 (2024-09-19)
SHQ23-3384 Add Google domain to connect-src in csp_whitelist.xml
20.6.5 (2024-10-21)
SHQ23-3585 Fix issue with apartment numbers being omitted in address book
20.6.7 (2025-01-31)
INFRA-893 Added missing build mp step
20.6.8 (2025-02-06)
SHQ23-4310 Fix error in customer address book phtml file
20.6.9 (2025-08-21)
SHQ23-5374 Fixing copyrights
20.6.10 (2025-08-21)
SHQ23-5374 Fix unescaped output in phtml
20.6.11 (2025-11-06)
INFRA-1328 - Removed incorrect case-sensitive version of file
21.0.0 (2025-12-19)
SHQ23-5984 Migrate to new Google Places API
21.0.1 (2026-01-05)
SHQ23-6882 Update CSP whitelist
21.0.2 (2026-01-21)
ENG26-182 Fix unescaped output
21.0.3 (2026-05-29)
ENG26-26 Update copyrights
21.1.0 (2026-06-18)
SHQ23-497 Fix autocomplete to populate the correct UK county/region
| Version | Stability | QA Status | Compatibility | Released |
|---|---|---|---|---|
| 21.1.0 | stable | Pass | Magento 2.4.7-2.4.9 Details | 2026-06-18 16:09:36 |
| 21.0.3 | stable | Pass | Magento 2.4.7-2.4.9 Details | 2026-05-29 08:42:34 |
| 21.0.2 | stable | Not tested | Not yet tested Details | 2026-01-21 13:12:16 |
| 21.0.1 | stable | Not tested | Not yet tested Details | 2026-01-05 12:03:33 |
| 21.0.0 | stable | Not tested | Not yet tested Details | 2025-12-19 15:44:43 |
| 20.6.11 | stable | Not tested | Not yet tested Details | 2025-11-06 11:25:27 |
| 20.6.10 | stable | Not tested | Not yet tested Details | 2025-08-21 16:40:32 |
| 20.6.9 | stable | Not tested | Not yet tested Details | 2025-08-21 13:54:02 |
| 20.6.8 | stable | Not tested | Not yet tested Details | 2025-02-06 11:39:41 |
| 20.6.7 | stable | Not tested | Not yet tested Details | 2025-01-31 09:22:03 |
| 20.6.6 | stable | Not tested | Not yet tested Details | 2025-01-30 16:57:39 |
| 20.6.5 | stable | Not tested | Not yet tested Details | 2024-10-21 13:35:33 |
| 20.6.4 | stable | Not tested | Not yet tested Details | 2024-09-19 13:49:53 |
| 20.6.3 | stable | Not tested | Not yet tested Details | 2024-06-03 12:35:59 |
| 20.6.2 | stable | Not tested | Not yet tested Details | 2023-04-13 11:27:01 |
| 20.6.1 | stable | Not tested | Not yet tested Details | 2022-05-24 10:22:42 |
| 20.6.0 | stable | Not tested | Not yet tested Details | 2022-01-24 10:40:52 |
| 20.5.1 | stable | Not tested | Not yet tested Details | 2022-01-17 11:18:57 |
| 20.5.0 | stable | Not tested | Not yet tested Details | 2021-11-30 16:00:38 |
| 20.4.0 | stable | Not tested | Not yet tested Details | 2021-06-01 13:37:48 |
| 20.3.3 | stable | Not tested | Not yet tested Details | 2021-04-01 09:04:45 |
| 20.3.2 | stable | Not tested | Not yet tested Details | 2020-12-21 10:03:03 |
| 20.3.1 | stable | Not tested | Not yet tested Details | 2020-06-18 16:04:56 |
| 20.3.0 | stable | Not tested | Not yet tested Details | 2018-12-18 19:17:23 |
| 20.2.0 | stable | Not tested | Not yet tested Details | 2018-05-09 09:38:02 |
| 20.1.3 | stable | Not tested | Not yet tested Details | 2018-02-01 10:02:29 |
| 20.1.2 | stable | Not tested | Not yet tested Details | 2018-01-10 09:51:49 |
| 20.1.1 | stable | Not tested | Not yet tested Details | 2017-11-28 01:58:15 |
| 20.1.0 | stable | Not tested | Not yet tested Details | 2017-10-13 12:00:20 |
| 20.0.6 | stable | Not tested | Not yet tested Details | 2017-08-29 15:09:00 |
| 1.0.5 | stable | Not tested | Not yet tested Details | 2017-07-13 16:41:46 |
| 20.0.5 | stable | Not tested | Not yet tested Details | 2017-07-13 16:41:46 |
| 1.0.4 | stable | Not tested | Not yet tested Details | 2017-07-12 13:09:14 |
| 1.0.3 | stable | Not tested | Not yet tested Details | 2017-06-23 16:22:23 |
| 1.0.2 | stable | Not tested | Not yet tested Details | 2017-06-15 08:50:28 |
| 1.0.1 | stable | Not tested | Not yet tested Details | 2017-04-11 11:16:03 |
| 1.0.0 | stable | Not tested | Not yet tested Details | 2017-03-29 08:43:04 |
No dependencies declared
This package's composer.json doesn't declare any required, suggested, replaced, or conflicting packages.
Compatibility
Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.
Code Quality
Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge. A phpcs finding can't make a module incompatible.
Static analysis
Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.
PHPStan
Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases.
Tests
Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.
Unit tests
| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | ||
| 2.4.8 | N/A | N/A | ||
| 2.4.9 | N/A | N/A |
Integration tests
| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | ||
| 2.4.8 | N/A | N/A | ||
| 2.4.9 | N/A | N/A |
Security
Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.
More from shipperhq
View vendorShipping Tracker - By the ShipperHQ Team
ShipperHQ Common
ShipperHQ Logger
Magento Shipping integration with ShipperHQ
Turn an existing module into recurring revenue.
If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.