Customer Attributes

Customer attributes allow you to add custom information to the customer and add fields to the checkout and customer registration forms.

Located in Customers > Attributes

📘

By default you will see DOB, Gender and Suffix Attributes for managing. You can click to add a new attribute.

🚧

NOTE: Customer Attributes are different from Order Attributes

Customer Attributes are specific to the customer or specific to the customer's business that may be required or helpful for registration as a customer. Order Attributes are information specific to the order being placed. A customer may enter different information into an Order Attribute for each Order Placed. Customer Attribute information mostly remains constant.

Create New Attribute

Click the Create New Attribute button to add a new attribute

Settings

Attribute Name

Give your attribute a unique name that is easy to understand. i.e. Customer Notes.

Attribute Type

Select from the following options:

  • Text (single line field for short text)
  • WYSIWYG (multi-line field for longer text)
  • Yes/No
  • Multiselect (Set options in the "Values" section after saving)
  • DropDown (Set options in the "Values" section after saving)
  • Date
  • File (gives the user the ability to upload a file)

Entity Type

  • Customer - This applies the attribute to the "Customer"
  • Address - This applies to attribute to each "Address". Since customers can have multiple addresses, each address can have a unique value for the attribute.

Visibility

Use for Search in the Customer Grid

Setting to Yes will allow you to search for customers in the Zoey Admin by the values of this attribute.

Available as Column in Order Grid

Setting to Yes will allow you to add this attribute as a column in Customers > Customers List in the Zoey admin.

Show on PDFs

Setting to Yes will show the value of this attribute on Order, Invoice, Shipment etc... PDF Files that can be downloaded in the Admin or Store Frontend by the customer.

👍

This setting will only show after saving a new attribute

Show on Emails

Setting to Yes will show the value of this attribute on Order, Invoice, Shipment etc... Emails that are sent to the customer.

👍

This setting will only show after saving a new attribute

Show on Customer My Account: View Order/Quote

This setting allows you to configure to show on the Order/Quote in the:

  • Admin Only
  • Storefront (Customer) Only
  • Both Admin and Store

Forms

Required for All Forms

This will set all below forms to Is Required = YES

Customer Create / Edit / View Form (Admin)

This will add the attribute form to the Customer Edit screen in the admin

Customer Registration Form (Store Frontend)

This will add the attribute form to the Customer Registration Form for the Customer.

Edit Customer Form (Store Frontend)

This will add the attribute form to the Edit Account Information screen in the Customer's My Account dashboard.

Checkout Registration Form

This will add the attribute form to the Registration Form during checkout.

Order Creation Form (Admin)

This will add the attribute form to the Create Customer screen when placing an order in the Admin.

Restricted Customer Group Form

This will add the attribute form to the Custom Registration URL page enabled in Customers > Settings > Require Approval

Show on Export Full Customer Data CSV

This will show the attribute value on the Customer Data CSV Export.

Sort Order In Forms

Set a value to sort this attribute if multiple attribute forms are enabled.

Add Drop Down / Multiselect Values

After saving a new Drop-Down or Multiselect Attribtue you will be able to add "Values" or options available for selection where the form is presented to the user.

Add Customer Attributes To Your Email Templates

To add customer attributes to your email templates you need to follow this variable format:

{{htmlescape var=$customer.attribute_code}}

For example if your customer attribute is "company_name" the variable is:

{{htmlescape var=$customer.company_name}}