Adding custom fields to contacts

Enterprise license required

Features described on this page require the Kentico Xperience Enterprise license.

Custom fields may help you store and organize additional data about your contacts when you, for example, integrate Xperience with a third party system. If you need to gather data about contacts that is not collected by the default fields, you can add custom fields to contacts.

 Added custom fields can be displayed among other editable fields of the contact editing interface or on the separate Custom data tab of the contact managing interface.

Adding custom fields to contacts

Custom fields may store values such as text, date and time, and boolean values. To define custom fields:

  1. Open the Modules application.

  2. Edit () the Contact management module.

  3. Switch to the Classes tab.

  4. Edit () the Contact management - Contact class.

  5. Switch to the Fields tab.

  6. Create a new category below the last field in the fields listing (ContactSalesForceLeadReplicationRequired in the default implementation).

  7. Create a new field based on your requirements and place it inside the new category.

    • Leave Standard field in Field type.
    • Leave the Display field in the editing form check box selected.
  8. Click Save.

Now you have created a custom field to gather details about your contacts. You can view and edit the values of your new custom field on the Profile tab of the contact managing interface.

Custom fields on the Profile tab are visible only when they contain a value which is not empty for the given contact. Empty fields are hidden by default.

Moving fields in contact detail categories

When you have created multiple custom fields, you can organize the fields displayed on the contact’s Details tab by moving them.

  1. Open the Modules application.
  2. Edit () the Contact management module.
  3. Open the Classes tab.
  4. Edit () the Contact management - Contact class.
  5. Switch to the Fields tab.
  6. Select the field in the list.
  7. Move the item using the Move up ( ) or Move down ( ) buttons.

Moving fields in the list changes their positions in the resulting form.

Displaying custom data on a separate tab

When you have gathered a lot of custom data, you can distinguish between the custom data and the data collected by the default fields by displaying the custom data on a separate tab of the contact editing interface.

To be able to render the custom data on the separate tab, you first need to create the custom page and then create the tab for displaying the page’s content.

Creating a custom page with the contact card

To create the custom page for displaying the contact card and custom contact data:

  1. Open your Xperience administration project in Visual Studio (using the WebApp.sln file).

  2. Navigate to the ~/CMSModules/ContactManagement/Pages/Contact folder.

  3. Create a copy of the Details.aspx file under the Contact folder.

  4. Rename the file to, for example, CustomData.aspx.

  5. Change the class name in the CustomData.aspx.cs and CustomData.aspx files.

  6. Replace the content in the CustomData.aspx file with:

    Example
    
    
    
      <div data-ng-controller="app as $ctrl">
         <cms-card-wrapper contact-id="$ctrl.contactId"></cms-card-wrapper>
     </div>
    
     <!-- any content -->
    
    
     
  7. You will get the following result:

    Example
    
    
    
      <asp:Content ID="cntBody" runat="server" ContentPlaceHolderID="cpAfterForm" ng-strict-di>
         <div data-ng-controller="app as $ctrl">
           <cms-card-wrapper contact-id="$ctrl.contactId"></cms-card-wrapper>
         </div>
    
         <!-- any content -->
     </asp:Content>
    
    
     
  8. Insert your custom content under the contact card section.

Now that you have created the custom page for displaying the contact card and inserted your custom data, you can create a new tab in the administration interface.

Creating a new tab in the user interface

To create a separate tab in the contact editing interface for displaying the content of your custom page:

  1. Open the Modules application.
  2. Edit () the Custom module.
  3. Switch to the User interface tab.
  4. Navigate to the Administration -> On-line marketing -> Contact management -> Contacts -> Contact properties tree item.
  5. Click New element.
  6. Enter Custom data in the Display name field.
  7. Select URL in the Type field.
  8. In the Target URL field, enter the ~/CMSModules/ContactManagement/Pages/Contact/CustomData.aspx path to the created custom page.
  9. Click Save.

The custom page content is now displayed on the Custom data tab of the contact managing interface.