Important

You are browsing upcoming documentation for version 6.1 of OroCommerce, scheduled for release in 2025. Read the documentation for version 6.0 (the latest LTS version) to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

Configure Global Address Validation Settings 

Note

The Address Validation feature can be configured on the global, organization, and website levels.

The Address Validation feature ensures that user-entered shipping or billing addresses are accurate, recognized by the shipping service, and can be used for precise shipping cost estimation.

When a customer or admin user enters a new address, the system validates it through an external address validation service (UPS or FedEx) and provides suggestions if needed. If the entered address is valid, no changes are required, and no popup is triggered. If the service suggests corrections, the user is asked to choose an address:

  • 1 to 3 suggestions: Each is displayed as a radio button, with the first suggested address selected by default. The changes are highlighted in the storefront and underlined in the back-office.

Address Validation popup dialog with 2 suggestions to the entered address in the storefront and back-office

  • More than 3 suggestions: The original address and a suggested address radio button are displayed, while all suggested addresses appear in a dropdown. The first suggested address is pre-selected. The changes are highlighted in the storefront and underlined in the back-office.

Address Validation popup dialog with suggestions to the entered address appear in a dropdown in the storefront and back-office

  • Update or save an adjusted shipping or billing address: Users also have the possibility to update or save an adjusted address. In the validation popup, alongside address suggestions, the Update Address or Save Address options may be available. Update Address allows the system to automatically apply the corrected address throughout the system where it is used. Save Address allows to save the adjusted address as a new address in the system.

Address Validation popup dialog with the Update Address or Save Address options available alongside address suggestions

Prerequisites 

Before you enable the address validation feature, ensure that you have properly configured either UPS or FedEx shipping integration for your application.

Configuration 

To enable the address validation feature:

  1. Navigate to System > Configuration in the main menu.

  2. Select Commerce > Shipping > Address Validation in the menu to the left.

    Note

    For faster navigation between the configuration menu sections, use Quick Search.

    Global address validation configuration without additional options

  3. Under the General section, select a shipping service whose databases will be used to verify the entered shipping or billing addresses in real-time (clear the Use Default checkbox to customize the settings).

  4. Save the settings for additional options to appear.

  5. Under the Storefront section, select the places where address validation should be triggered in the storefront, such as under My Account > Address Book menu when adding or modifying a billing or shipping address, or during checkout. By default, the system validates only shipping addresses.

    Global address validation configuration with additional storefront options

  6. Under the Back-Office section, select the places where address validation should be triggered in the back-office, such as:

    • under the Customers menu when adding or modifying a billing or shipping address for a customer or customer user

    • under Sales > Orders when adding or modifying a billing or shipping address for the order receiver

    • under Sales > Quotes when adding or modifying a shipping address for the quote receiver

By default, the system validates only shipping addresses.

Global address validation configuration with additional back-office options