---
title: "Custom Fields"
slug: "custom-fields"
updated: 2026-11-11T14:36:44Z
published: 2026-11-11T14:36:44Z
canonical: "help.commbox.io/custom-fields"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.commbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Custom Fields

## ![](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/Custom%20fields%20logo.png)

## Overview

The **Custom Fields** module lets organizations customize the customer information available in CommBox according to their business needs.

In addition to standard customer fields such as first name, last name, phone number, and email address, you can create custom fields for information specific to your organization, such as customer type, account number, membership level, or preferred branch.

The module also controls which standard and custom fields are displayed in the **Customer Pane**.

Custom fields can also be included in **Customer Reports**, allowing exported reports to contain organization-specific customer information in addition to the standard customer fields.

![](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/Custom%20Fields.png)

## Key Considerations

- CommBox defines standard customer fields, while your organization creates custom fields.
- You can display or hide both standard and custom fields in the **Customer Pane**.
- To change the order in which fields are displayed, hover over the beginning of the field row until the grab icon appears, then click and drag the row to the desired location.

![](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/changing%20the%20order.png)

- Standard customer fields are always included when exporting a **Customer Report**, regardless of whether they are displayed in the **Customer Pane**.
- Custom fields can be added to **Customer Reports** as needed.
- Hiding a field from the **Customer Pane** does not delete the field or its stored customer data.

## Adding a New Field

To create a custom customer field:

1. Navigate to **Settings > Custom Fields** and click **+ Add Field**.
2. In the dialog box, configure the following:
  1. Select the **Input Type** for the new field. The selected type determines the type or format of data that can be entered, such as integers or email addresses.
  2. Enter the field's **technical name**. Only letters, numbers, and underscores are accepted. We recommend using a short, descriptive name.
  3. Enter the **display name** that will appear in the Customer Pane.
  4. Add **Validation**, if needed, to define additional restrictions on the values that can be entered.
  5. Configure whether the field should be displayed in the **Customer Pane**.
  6. Configure whether the field should be included in **Customer Reports**.
3. Click **Add**.
4. Click **Save** to save the new settings.

The new field can now be used to store the relevant information in customer records.

![](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/Custom%20Field%20module%20-%20add%20new%20field.png)

## Editing and Deactivating Fields

To edit an existing field, click the Edit icon (pencil) at the end of its row.

![](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/edit%20and%20deactivate%20fields.png)

Update the configuration and click **Add**.

To deactivate a custom field, hover over its row and click the **Deactivate** icon at the end of the row. Click **Deactivate** in the confirmation dialog.

Inactive fields no longer appear in the Customer pane, search, public API, or exports. The field’s unique name remains reserved, allowing you to reactivate it at any time by clicking **Reactivate** when hovering over the inactive field.

![](https://cdn.document360.io/cce107c7-3390-46bd-a6cf-3120b27c4105/Images/Documentation/reactivate%20field.png)

**Note:** System fields cannot be deactivated. You can only hide them from agents in the customer pane.

## Creating a Customer Report

Customer Reports contain the standard customer fields and can also include custom fields configured for reporting.

To create a Customer Report:

1. Navigate to **Insights > Customers**.
2. Click **Export** at the top of the page.
3. CommBox generates the report using the available customer data. Once the report is ready, click **Download**.

The exported report always includes the standard customer fields. Custom fields configured for inclusion in Customer Reports are added as additional fields.