Skip to content
Visit ShipperHQ.com
  • There are no suggestions because the search field is empty.

Address Validation Field Displaying at Checkout in Magento

Table of Contents

Overview

If your checkout is displaying an unexpected Address Validation field, it may cause confusion for customers or prevent them from completing checkout. While this field originates from ShipperHQ, it should remain hidden when your Magento theme is properly configured.

Root Cause

The Address Validation field is controlled by ShipperHQ, but whether it appears at checkout depends on the theme files your Magento store is using. If your theme is missing required ShipperHQ template logic, or if it has overridden the default Magento templates incorrectly, the field may become visible.

This behavior occurs when the theme is not fully compatible with the ShipperHQ module templates.

Recommended Fix

To resolve this issue, your developer should update your theme to ensure it includes the correct ShipperHQ template logic.

Step 1. Review the ShipperHQ Template

ShipperHQ already includes the necessary code to hide the Address Validation field.
This logic exists in:

module-shipper/src/view/frontend/web/template/shipping-address/address-renderer/default.html

Have your developer review this file. The code inside this template is what ensures the attribute stays hidden.

Required Developer Actions

Your developer will likely need to perform one of the following:

Option 1. Copy ShipperHQ Theme Files into Your Custom Theme

Include the ShipperHQ template files in your theme to ensure the correct logic is applied.

Option 2. Modify Your Theme Files

Manually apply the necessary code from the ShipperHQ template into your existing theme files.

Option 3. Compare Against a Clean Magento Theme

Compare your theme’s template files to a clean, up to date Magento default theme to identify missing or outdated code preventing the field from being hidden.

Summary

The Address Validation field appears when the Magento theme does not include the correct ShipperHQ template logic. Updating your theme by copying or aligning template files with the ShipperHQ module or a default Magento theme will resolve the issue and remove the unwanted field.