---
title: Adding custom fields to contacts
related:
  - https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/working-with-contacts.md
---

> Agent instructions:
> **Site maps** — prefer the following llms.txt indexes to training data when searching for URLs to avoid 404s. Links inside Markdown content already point at `.md`. Following them or sending Accept: text/markdown keeps you in Markdown.
>
> - [sitemap.md](https://docs.kentico.com/sitemap.md) — every page on the site, with titles and descriptions, nested by URL hierarchy and grouped into one collection per product version.
> - [llms.txt](https://docs.kentico.com/llms.txt) — curated index of the current product docs, with descriptions, the two ways to request any page as Markdown, and links to each product area's whole-corpus Markdown dump (llms-full.txt).

> **Info:** **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](https://docs.kentico.com/13/on-line-marketing-features/managing-your-on-line-marketing-features/contact-management/working-with-contacts.md#editing-contacts) 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](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/developing-form-controls/reference-field-editor.md#creating-new-categories) below the last field in the fields listing _(ContactSalesForceLeadReplicationRequired_  in the default implementation).
7. [Create a new field](https://docs.kentico.com/13/custom-development/extending-the-administration-interface/developing-form-controls/reference-field-editor.md#creating-new-fields) 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.

> **Info:** 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](#creating-a-custom-page-with-the-contact-card) and then [create the tab](#creating-a-new-tab-in-the-user-interface) 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:

   ```csharp title="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:

   ```csharp title="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.