Field Types
All supported custom field types and how to configure them
Field Types
Custom fields are defined in Project Settings > Custom Fields. Changes apply immediately across all widgets in the project.
Creating a Field
- Go to Project Settings > Custom Fields
- Click Add Field
- Choose a type, enter a label, and configure any options
- Click Save
The field is immediately available to enable on any widget in the project from the Widget Builder.
Supported Types
Text
A single-line text input.
| Property | Description |
|---|---|
| Label | Display label shown to the user |
| Placeholder | Hint text shown inside the input |
| Min length | Minimum number of characters required |
| Max length | Maximum number of characters allowed |
Example use cases: Order ID, company name, job title.
Textarea
A multi-line text input for longer responses.
| Property | Description |
|---|---|
| Label | Display label shown to the user |
| Placeholder | Hint text shown inside the input |
| Min length | Minimum number of characters required |
| Max length | Maximum number of characters allowed |
Example use cases: Describe the issue, steps to reproduce, expected behavior.
Number
A numeric input field.
| Property | Description |
|---|---|
| Label | Display label shown to the user |
| Placeholder | Hint text shown inside the input |
| Min value | Minimum numeric value allowed |
| Max value | Maximum numeric value allowed |
Example use cases: Team size, account ID, invoice number.
An email address input with format validation.
| Property | Description |
|---|---|
| Label | Display label shown to the user |
| Placeholder | Hint text shown inside the input |
The submitted value is validated as a properly formatted email address.
Example use cases: Alternative contact email, work email when the user may be submitting from a personal device.
Select
A dropdown with a predefined list of options.
| Property | Description |
|---|---|
| Label | Display label shown to the user |
| Options | List of selectable values |
Add at least two options. Users pick exactly one from the list.
Filterable in the inbox. Select fields can be used as filters on the feedback inbox — open the Add Filter menu and choose Custom field to narrow feedback by any project's dropdown value.
Example use cases: Department, subscription plan, product area, issue type.
Checkbox
A boolean toggle — checked or unchecked.
| Property | Description |
|---|---|
| Label | The statement the checkbox represents |
Stored as true or false.
Example use cases: "This is blocking my work", "I'm a paying customer", "I'd like a follow-up".
Date
A date picker input.
| Property | Description |
|---|---|
| Label | Display label shown to the user |
| Placeholder | Hint text shown inside the input |
Submitted as YYYY-MM-DD format.
Example use cases: Expected delivery date, issue start date, contract renewal date.
Default Fields
Every project includes four built-in fields that can be enabled per widget without being created manually:
| Field ID | Label | Type | Auto-promotes to |
|---|---|---|---|
df_name | Name | Text | User name in Context card |
df_email | User email in Context card | ||
df_phone | Phone | Tel | User phone in Context card |
df_company | Company | Text | — |
Default fields cannot be deleted or renamed, but you can control whether they are required.
Enabling Fields on a Widget
Fields defined in Project Settings are not shown on every widget automatically. Enable them per widget:
- Open the Widget Builder for the widget you want to configure
- Navigate to the Fields tab
- Toggle on the custom fields you want to appear in the form
Field IDs
Each project-defined field has an auto-generated ID with a cf_ prefix (e.g. cf_a8k2m1p5). The ID is shown below the field label in Project Settings > Custom Fields.
Field IDs are used when submitting values via the REST API or when reading field values from API responses. See REST API — Custom Fields for the full reference.