Note: Available only for new signups after the 31 March, 2026 release. If you signed up earlier, refer to the existing ITAM documentation.

Custom fields allow you to define and store unique attributes that are not included in the default Freshservice schema. You can add these fields to buildings, rooms, racks, customers, devices, assets, application components, circuits, and passwords. These fields can also be used for filtering in list views and generating detailed reports.

This article provides an overview of the custom fields feature and instructions on how to add, edit, and manage custom attributes for your records in Freshservice.

Prerequisites

You need the following before the configuring custom fields:

• Administrative privileges to access the Custom fields option under Admin>Asset Management.

• A list of the specific object types (such as Devices or Assets) that require additional attributes.

Add a custom field

To create a new custom field, follow these steps:

1. Go to Admin > Asset Management > Custom Fields.

2. Click on a specific object type (for example, Assets or Devices).

3. Click Add new to create a field, or select an existing field to edit.

4. Enter a name for the custom field in the Field field.

5. Select a data type from the Type dropdown menu. To learn about available data types, see the Custom field data types section below.

6. (Optional) Select the Filterable checkbox to add the field to the More Filters dropdown on the list page for that object.

7. (Optional) Select the Mandatory checkbox.
   Note: Mandatory fields are only enforced when you add or edit objects via the UI. This is not enforced via the API.

8. Click Save.

Set custom field values in bulk

To update multiple records at once, follow these steps:

1. Go to the list page of the target object (for example, All Devices).

2. Select the records you want to modify.

3. Click the More options (three vertical dots) icon and select Set Custom Field Value.

4. Choose the specific custom field and enter the new value.

5. (Optional) Add a note in the provided field.

6. Click Apply.

Create custom fields for secrets

To add a custom field to the Secrets form for storing additional values, follow these steps:

1. Go to Admin > Asset Management > Custom Fields.

2. Click Secrets and then click Add new.

3. On the Add Secret Custom Field page, provide details for the following fields:

   • Name: Enter a unique name for the field.

   • Type: Select the appropriate data type from the dropdown menu. To learn about available data types, see the Custom field data types section below.

   • Filterable or Mandatory (Optional): Select the checkboxes to make the field searchable or required for saving.

Note: The Log for API option is enabled by default to record any changes made to this field via the API in the history log.

4. Click Save.

Custom field data types

The following data types are available in the Type dropdown menu on the Add Custom Field page:

• Text: Stores character-based values.

• Number: Stores numeric values.

• Date: Uses calendar date formatting.

• Yes/No: Stores boolean (True/False) values.

• URL: Stores web address values.

• Picklist: Provides single-select or multi-select lists. You can adjust picklist parameters after creation without reassigning the fields.

• JSON: Stores data in JSON formatting.

• Markup: Stores data in markup formatting.