Customer Address Attributes

The Customer Address Attribute determines the properties of street addresses that are entered into the address book from the customer’s account, or during checkout.

Custom address attributes can be set up if you need to provide additional information such as an optional email address, Skype account, alternate phone number, building, or county. The custom attribute can then be incorporated into the address template that is used to produce sales documents. The process to create a custom address attribute is almost the same as creating a customer attribute.

Customer address attributes are used in the following forms:

Customer Address Attributes

Step 1: Complete the Attribute Properties

  1. On the Admin sidebar, tap Stores. Then under Attributes, choose Customer Address.

  2. In the upper-right corner, tap Add New Attribute.

    Customer Attribute Properties

  3. In the Attribute Properties section, do the following:

    • Enter a Default Label to identify the attribute during data entry.

    • Enter an Attribute Code to identify the attribute within the system.

      The attribute code must begin with a letter, and can include any combination of lowercase letters (a-z) and numbers (0-9). The code must be less than thirty characters in length, and cannot include special characters or spaces. The underscore character (_) can be used to indicate a space.

      Shortcut: To complete only the required fields at this time, scroll down to Storefront Properties, enter the Sort Order, and save.

  4. Complete the following:

    Data Entry Properties

    • To determine the type of input control that is used for data entry, set Input Type to one of the following:

      • Text Field
      • Text Area
      • Multiple Line
      • Date
      • Dropdown
      • Multiple Select
      • Yes/No
      • File (attachment)
      • Image File
    • If the customer must enter a value in the field, set Values Required to “Yes”.

    • To assign an initial value to the field, enter a Default Value.

    • To check the data entered into the field for accuracy before the record is saved, set Input Validation to the type of data to be allowed in the field. The available values depend on the Input Type specified.

      None The field has no input validation during data entry.
      Alphanumeric Accepts any combination of numbers (0-9) and alphabetic characters (a-z, A-Z) during data entry. To include special characters, see Escape HTML Entities.
      Alphanumeric with Space Accepts any combination of numbers (0-9), alphabetic characters (a-z, A-Z), and spaces during data entry.
      Numeric Only Accepts only numbers (0-9) during data entry.
      Alpha Only Accepts only alphabetic characters (a-z, A-Z) during data entry.
      URL Accepts only a URL during data entry.
      Email Accepts only an email address during data entry.
      Length Only Validates the input based on the length of the data entered into the field.
    • To apply a preprocessing filter to values entered in a text field, text area, or multiple line input type, set Input/Output Filter to one of the following:

      None Does not apply a filter to text entered into the field.
      Strip HTML Tags Removes HTML tags from the text. This filter can help clean up data that is pasted into a field from another source that includes HTML tags.
      Escape  HTML Entities Converts special characters found in the text to a valid HTML escape sequence, such as &amp;. Escape sequences are enclosed between an ampersand and a semi-colon, and are frequently used for typographer’s smart quotes, copyright and trademark symbols. Escape sequences are also used to identify characters such as the less than (<) and greater than (>) symbols, and the ampersand character which are also used in the code. This filter can help clean up special characters that are sometimes pasted into database fields from word processors.

    Customers Grid and Segment Properties

    • To be able to include the column in the Customers grid, set Add to Column Options to “Yes”.

    • To filter the Customers grid by this attribute, set Use in Filter Options to “Yes”.

    • To search the Customers grid by this attribute, set Use in Search Options to “Yes”.

    • To make this attribute available to customer segments, set Use in Customer Segment to “Yes”.

Step 2: Complete the Storefront Properties

  1. To make the attribute visible to customers, set Show on Storefront to “Yes”.

  2. Enter a number in the Sort Order field to determine its order of appearance when listed with other attributes.

  3. Set Forms to Use to each form that is to include the attribute. To choose multiple options, hold the Ctrl key down and click each form.

    Storefront Properties

Step 3: Complete the Labels/Options

  1. In the panel on the left, choose Manage Labels/Options.

  2. Under Manage Titles, enter a label to identify the attribute for each store view.

  3. When complete, tap Save Attribute.

    Manage Labels/Options

Field Descriptions

Field Description
Attribute Properties
Default Label

The default label that identifies the attribute in the Admin and storefront.

Attribute Code

A unique code that identifies the attribute within the system. The code can be up to 21 characters in length, and cannot include spaces or special characters. The underscore symbol can be used instead of a space.

Input Type Determines the input control that is used for data entry. Options:
Text FieldA single-line text field.
Text AreaA multi-line text area.
Multiple LineCreates multiple text lines for the attribute, similar to a multi-line street address. The number of separate data entry lines can be from 2 to 20. Additional property:
Default ValueSpecifies the initial value of the field.
DateDisplays a date field with a pop-up calendar.Additional properties:
Default ValueSets a default date.
Minimal ValueDetermines the earliest date that can be entered.
Maximum ValueDetermines the latest date that can be entered.
Related properties:
Input ValidationDate
Input/Output FilterNormalize Date
DropdownA drop-down list that accepts only one value to be selected.
Multiple SelectA drop-down list that accepts multiple values to be selected. To select more than one value, hold down the Ctrl key, and click each option.
Yes/NoA field that offers only a choice of "Yes" or "No" values.
File (attachment)A field that allows a file to be uploaded, and associated with the customer attribute as an attachment.
Image FileA field that allows an image to be uploaded to the gallery, and associated with the customer attribute.
Values Required Determines if a value must be entered into the field. Options: Yes / No
Default Value

Specifies the initial value of the attribute.

Input Validation The selection of options is determined by the input type. Options:
NoneThe field has no input validation during data entry.
AlphanumericAccepts any combination of numbers (0-9) and alphabetic characters (a-z, A-Z) during data entry.
Alphanumeric with SpaceAllows spaces in the street address to comply with maximum length requirements of carrier. During checkout, the customer can enter any combination of numbers (0-9), alphabetic characters (a-z, A-Z), and spaces in the street address of the recipient and sender. Any extra spaces are trimmed when the address is saved.
Numeric OnlyAccepts only numbers (0-9) during data entry.
Alpha OnlyAccepts only alphabetic characters (a-z, A-Z) during data entry.
URLAccepts only a URL during data entry.
EmailAccepts only an email address during data entry.
Length OnlyValidates the input based on the length of the data entered into the field.
Input/Output Filter Applies a preprocessing filter to values entered in a text field, text area, or multiple line input type before the record is saved. Options:
NoneDoes not apply a filter to text entered into the field.
Strip HTML TagsRemoves HTML tags from the text. This filter can help clean up data that is pasted into a field from another source that includes HTML tags.
Escape  HTML EntitiesConverts special characters found in the text to a valid HTML escape sequence, such as &amp;. Escape sequences are enclosed between an ampersand and a semi-colon, and are frequently used for typographer’s smart quotes, copyright and trademark symbols. Escape sequences are also used to identify characters such as the less than (<) and greater than (>) symbols, and the ampersand character which are also used in the code. This filter can help clean up special characters that are sometimes pasted into database fields from word processors.
Add to Column Options Specifies if the attribute is included as a column in the Customers grid. Options: Yes/No
Use in Filter Options Specifies if the attribute can be used as a filter for search operations from the grid. Options: Yes/No
Use in Search Options Specifies if the attribute value can be used as a keyword in search operations. Options: Yes/No
Use in Customer Segment Determines if the attribute is included in customer segment conditions. Options: Yes/No
Storefront Properties
Show on Storefront Determines if the attribute appears as a field in the customer information in the storefront. Options: Yes/No
Sort Order Specifies the sort order of this attribute in relation to other customer attributes. The sort order determines the sequence that fields receive focus during data entry when using keyboard navigation.
Forms to Use in Determines the pages with data entry forms where the attribute appears. Hold down the Ctrl key to choose multiple forms. Options: Customer Address Registration, Customer Account Address