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.

Create an Address 

For customers, customer users, and contacts in the Oro application, the address book allows to enter and view account address details.

To add an address to the address book:

  1. Click Add Address in the right corner.

    Click Add Address in the right corner of the selected page

    A popup form appears with the following fields to fill in:

    Field

    Description

    Types

    Defines the type of the address to be entered:

    • Billing

    • Shipping

    • Default Billing

    • Default Shipping

    Note: More than one type can be selected for one address.

    Primary

    Checking the Primary box marks the address primary. Note that only one primary address is possible. Marking a different address primary will by default delete this mark from the address that has previously been marked Primary.

    Label

    Identify the address by adding a label. This can help distinguish addresses if there is more than one address in the address book for one account.

    Name prefix

    If applicable, add a prefix to the name, e.g., Dr., Mrs., etc.

    First name

    Enter the first name of the account representative.

    Middle name

    Enter the middle name of the account representative.

    Last name

    Enter the last name of the account representative.

    Name suffix

    If applicable, add a suffix name, e.g., IV, Jr., etc.

    Organization

    Specify the organization represented by the account.

    Country*

    This field is mandatory. Select the country from the list. Selecting a country prompts additional fields to appear (Street, City, State, Zip/postal code, Phone). Street, City, and Zip are mandatory fields.

Note

Either the Organization or the First and Last Name fields are mandatory.

  1. Click Save once you have filled all the fields.

    The address and the map showing the address location is displayed on the right of the address.

    The address and the map are shown on the right of the address

View an Address on the Map 

It is possible to add more addresses to the same account. If you have more than one address on the Address Book page, clicking on one or the other will prompt a map to appear that corresponds to the selected address.

Click an address to trigger the map that corresponds to the selected address

Please be aware that a valid Google API key is required to display maps in the storefront. Please see the back-office settings for more information.

Manage an Address 

  • Mark address as primary - To mark the address as primary, click on the right top of the address background, check the Primary box and click Save. The primary label will move to the updated address.

Note

Delete is disabled for the primary address. To delete the address marked as primary, you must first move the primary label to a different address.

  • Edit an address - To edit an address, click on the top right of the address background, update the address details, and click Save.

  • Delete an address - Delete an address by clicking Trash-SVG next to it.