Step 2: Complete the storefront properties
-
Scroll down to the Storefront Properties section.
-
To make the attribute visible to customers, set Show on Storefront to
Yes
. -
Enter a number in the Sort Order field, which determines its order of appearance when listed with other attributes.
-
Set Forms to Use to each form that is to include the attribute. To choose multiple options, hold down the Ctrl key and click each form.
Step 3: Complete the label and save
-
In the left panel, choose Manage Labels/Options.
-
Under Manage Titles, enter a label to identify the attribute for each store view.
-
When complete, click Save Attribute.
Field descriptions
Attribute Properties
Field | Description |
---|---|
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 60 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 Field - A single-line text field.Text Area - A multi-line text area.Multiple Line - Creates 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.Date - Displays a date field with a pop-up calendar.Dropdown - A drop-down list that accepts only one value to be selected.Multiple Select - A drop-down list that accepts multiple values to be selected.Yes/No - A 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 File - A 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: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.Alphanumeric with Space - Allows 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 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. |
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: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 symbols, 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 |
Grid Filter Condition Type | Specifies the filter-matching conditions for attributes for search operations from the grid. It does not affect the Search by keyword field for the grid. Options: Partial Match / Prefix Match / Full Match |
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
Field | Description |
---|---|
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. Options:Customer Registration Customer Account Edit Admin Checkout |
Default customer attributes
Attribute code | Description |
---|---|
created_at | The date the customer account was created. |
updated_at | The date the customer account was last updated. |
website_id | The website ID of the site where the customer account was created. |
store_id | The store ID of the site where the customer account was created. |
created_in | The store view where the account was created. |
group_id | The ID of the customer group where the customer is assigned. |
disable_auto_group_change | Determines if customer groups can be dynamically assigned during VAT ID validation. |
prefix | Any prefix that is used with the customer name (such as Mr., Ms., or Dr.). |
firstname | The first name of the customer. |
middlename | The middle name or middle initial of the customer. |
lastname | The last name of the customer. |
suffix | Any suffix that is used with the customer name. (such as Jr., Sr., or Esquire) |
email | The customer’s email address. |
dob | The customer’s date of birth. Important: In keeping with current security and privacy best practices, be aware of any potential legal and security risks associated with the storage of customers’ full date of birth (month, day, year) with other personal identifiers. It is recommended that you limit the storage of customers’ full birth dates and suggest using customer year of birth as an alternative. |
taxvat | The Value Added Tax (VAT) ID that is assigned to the customer. The default label of this attribute is VAT Number . The VAT number field is always present in all shipping and billing customer addresses when viewed from the Admin, but is not a required field. |
gender | The customer gender. |
Previous pageProvide shopper assistance
Next pageAddress attributes