Magento 2.1.18 is the final 2.1.x release. After June 2019, Magento 2.1.x will no longer receive security patches, quality fixes, or documentation updates.
To maintain your site's performance, security, and PCI compliance, upgrade to the latest version of Magento.

Address Form

This article discusses standards and rules for an address entry forms.

For solutions not described in this article, please refer to other related patterns or contact the Magento UX Design team.

When to Use / When Not to Use

The address entry fields should be used whenever an address needs to be captured. This set of form elements will be universal across the Magento user experience. This pattern should follow rules established in the Form Elements and related patterns.


The only variation of this pattern at this time is the North American Address Entry format. Users have the ability to create address entry formats for other locales within the system.

Fields That Make Up Address Entry (in order)

Label Input Type Required?
Address Line 1 Text Field Yes
Address Line 2 Text Field No
City Text Field Yes
State/Province Dropdown (Default can be localized) Yes
ZIP/Postal Code Text Field Yes
Country Dropdown (Default can be localized) Yes


This pattern will follow the Form standards established in the Form Elements and related patterns. Refer to the Form Elements and related patterns for style information.

Usage Example


Source files associated with this article are currently attached the Form Elements Pattern.