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 Address Validation Settings per Website 

Note

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

The Address Validation feature ensures that customer 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 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 per specific website:

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

  2. For the necessary website, hover over the more actions menu to the right of the necessary website and click to start editing the configuration.

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

    Note

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

    Website-level address validation configuration settings

  4. 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 Organization checkbox to configure the settings per website).

  5. Save the settings for additional options to appear.

  6. 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