If you signed up before Aug 9, 2021, please click Previous plans to view your applicable plans.

Customer fields in Freshdesk are highly customizable and can represent all your customer data in a bespoke, robust schema.


This article contains:

Before you begin

This article is the first in a series about Managing your Customers.

  1. Manage your Customer Data Schema—understand contacts, companies, and their respective fields.
  2. Manage Customer Data in Freshdesk—understand how to create, edit, delete, and manage contacts and companies.
  3. Personalize support using Customer Segments—filter and group customers and create automations and self service for them.

About Contacts and Companies

In Freshdesk, your customers are represented as Contacts and Companies.

  • A Contact is a single person, identified by their email address. Freshdesk automatically creates a contact for every new user who sends an email or submits a ticket.
  • A Company is a group of contacts from the same organization. Freshdesk automatically associates contacts with a company based on their registered domain name.

For both, Freshdesk provides a list of default fields. If you're on paid plans, you can also create custom fields.

Manage your schema with customer fields

Customer information is captured in a number of fields in both contacts and companies. If you're on the Growth plan or above, you can also create custom fields to capture specific information relevant to your business.

Default contact and company fields

To view the contact fields, go to Admin > Support Operations > Contact Fields. 
Similarly, to view Company fields, go to Admin > Support Operations > Company Fields.


Each field is described below:

TabFieldDescription
ContactsFull nameSingle-line text. The primary name field for the contact.
TitleSingle-line text. Use for a position or role.
EmailSingle-line text with validation. The primary email address for the contact
Work phoneNumber with validation. 1 of 2 phone fields for the contact.
Mobile phoneNumber with validation. 1 of 2 phone fields for the contact.
Other phone numbersDropdown field for additional phone numbers. Modify it to add labels for phone number type (such as "US Office" and "India Office").
TwitterSingle-line text. The Twitter ID of the contact.
CompanyDropdown field to hold a Company added to your Freshdesk. By default, this field accepts multiple companies. Modify to change this behavior.
AddressMulti-line text. The primary address for the contact.
Time zoneDropdown. The time zone of the contact. Only modifiable on paid plans.
LanguageDropdown. The language of the contact. Only modifiable on paid plans.
TagsDropdown with validation. Tags you've added to your account. Learn more.
AboutMulti-line text. A description of the contact.
Unique external IDSingle-line text. If you use an ID convention in other tools (such as account numbers), you can represent that same ID here.
CompaniesCompany NameSingle-line text. The primary name field for the company.
DescriptionMulti-line text. A description of the company.
NotesMulti-line text. Any additional details for the company.
Domains for this companyA special multi-input field to hold email domains for the company.
Health scorePaid plans only. A dropdown field to represent the customer relationship.
Account tierPaid plans only. A dropdown field to represent the contract tier.
Renewal datePaid plans only. A date field to serve as a reminder for contract renewal.
IndustryPaid plans only. A dropdown field to represent the customer industry.

Field properties

When you hover over a customer or contact field, you can delete the field by clicking the trashcan icon.
Note: You can only delete custom fields, not default fields.

Delete and Edit icons for customer fields.

To edit a field, click on it. This opens the field properties in a dialog as displayed below. Make the required changes and click Save field.


Contact FieldDescription
(Behavior for agents) Required when submitting the formMake a field mandatory for agents.
(Behavior for Customers) Display to customerCustomers can see this field in their profile. Fields that are not visible to customers have a lock icon next to them in the list of fields.
Lock icon indicates that a field is not visible to customers.
(Behavior for Customers) Customer can editCustomers can update this field in their profile.
(Behavior for Customers) Customer can see this when they Sign upCustomers can see this field in the signup form.
((Behavior for Customers) Required when submitting the formMake a field mandatory for customers during signup and while editing their profile.
LabelThe name of the field on the agent portal and the customer portal.
(Dropdown choices) Dropdown ItemsThe choices for a dropdown field.


Note: Unlike Contact fields, the properties of Company fields are not visible to customers.


Custom contact and company fields

Custom fields are available from the Growth plan onwards.


If you need additional customer information, you can create custom fields for both Contacts and Companies. You can create the following types of fields:

Field TypeDescription
Single-line TextAccept a single line of text. Suitable for first names, last names, and other phrases.
Multi-line TextAccept long text. Suitable for addresses, background information, and other descriptions.
CheckboxAccept a true or false value. Suitable for getting permissions.
NumberAccept a numeric value. Suitable for zip codes, costs or prices, etc.
DropdownAccept a value from a predefined list. Suitable for many different types of inputs.
Phone numberAccept a phone number.
URLAccept a link. Suitable for website links, Linkedin profiles, etc.
DateAccept a date value. Suitable for date of birth, scheduling, etc.


To create a new field:

  1. Go to Admin > Support Operations > Contact Fields and select Contacts. To create a custom Company field, go to Admin > Support Operations > Company Fields.
  2. Drag and drop a field icon to the list.
  3. Modify the field's properties and click Done.
  4. Reposition your field as required and click Save in the top-right. Your fields are now ready for use.
    • Agents can view these fields in the Contact Details widget on a ticket and in the Contacts and Companies pages.
    • If the fields are visible to customers, customers can see them in the Customer portal when they signup and when they edit their profile.

Customize Requester Widget

When agents view a ticket, they can see the requester's details in the Contact Details widget. See Understand the Ticket Details View.


As an admin, you can customize the fields that appear in the widget. To do so:

  1. Go to Admin > Support Operations > Contact/Company Fields and click Customize Requester widget.
  2. In the dialog, modify the fields visible.
    1. The Full name, Title, and Company Name fields cannot be removed.
    2. Click the minus icon next to a field to remove it.
    3. Click the plus icon at the bottom to add an existing Contact or Company field.
    4. Review your changes and click Save.


Once you've updated your customer data schema, you can create or import your data. See Manage Customer Data in Freshdesk and Import and Export Data in Freshdesk.