How custom fields work
Custom fields are tied to specific . When someone creates a ticket using a form, they see both standard system fields (like title and description) plus any custom fields configured for that form.Example: A “Bug Report” form might include custom fields for bug severity, browser type, and steps to reproduce. A “Feature Request” form might include custom fields for business justification, priority level, and target users.
Custom fields are only available when creating tickets through forms.
Field types
Text
Text
Single-line text input for short responses like names, titles, or brief descriptions.
Text area
Text area
Multi-line text input for longer descriptions, explanations, or detailed information.
Number
Number
Numeric input with validation for quantities, counts, or measurements.
Date
Date
Date picker for scheduling, deadlines, or date-related information. When used in a title template, date fields support format suffixes to control how the date displays in the generated title.
Time
Time
Time input for selecting specific times of day.
Duration
Duration
Time duration input for tracking time spans or estimated completion times.
Timezone select
Timezone select
Select from predefined timezone options for scheduling and time-related information.
Boolean
Boolean
Yes/No checkbox for binary choices or confirmations.
Select
Select
Single-choice dropdown menu from predefined options.
Multi-select
Multi-select
Multiple-choice dropdown menu allowing selection of multiple options.
User select
User select
Choose a single organization member for assignments or mentions.
User multi-select
User multi-select
Choose multiple organization members for assignments or mentions.
User group select
User group select
Select from in your organization.
- Configure an allowlist with no item limit to restrict which groups appear as options
- Filter by source to show only groups from a specific provider (Okta, Google Workspace, or groups created in Ravenna)
- Manually created groups only appear in their assigned workspace. Synced groups are visible across all workspaces.
Tag select
Tag select
Select from available to categorize tickets.
Application select
Application select
Select from applications connected to your organization.
Application multi-select
Application multi-select
Select multiple applications connected to your organization.
- Configure an allowlist with no item limit to restrict which applications appear as options
Application group select
Application group select
Select from application groups in your organization.
Type select
Type select
Select from predefined ticket type options (e.g., Service, Incident, Question).
Access level select
Access level select
Select from defined access levels for permission management.
File picker
File picker
Upload files and attachments to tickets. Configure allowed file types and size limits.
Create custom fields
Through settings
Through settings
Create custom fields centrally in workspace settings:
1
Navigate to fields
Go to Settings > Fields in your workspace.
2
Create field
Click Create Custom Field.
3
Configure field
Fill in the required information:
- Label: The name that appears on the form
- Description: Help text explaining what this field is for
- Type: Choose from available field types
- Required: Toggle whether this field must be filled out. Turning this on at the workspace level makes the field required everywhere it appears and locks the per-form Required toggle so individual forms cannot opt out.
4
Save field
Click Create to save your custom field.
Through form builder
Through form builder
Create and manage custom fields directly within :
1
Navigate to forms
Go to Settings > Forms.
2
Select form
Select an existing form or create a new one.
3
Add fields
Drag and drop fields from the right panel into your form. The right panel has three tabs:
- Custom: Create new custom fields
- Existing: Use existing custom fields from other forms
- System: Add system fields
4
Edit fields
Use the dropdown menu in each custom field item to edit field properties.
5
Set visibility
Toggle the private option to make a custom field visible only for the current form.
Use existing fields
Existing custom fields are non-private fields created from other forms or settings. Find them in the Existing Custom Fields tab in the form builder. These fields are shared across forms, meaning you can reuse them without recreating them.When you update an existing custom field that’s shared across multiple forms, the changes apply to all forms using that field.
Per-form label and description overrides
Override the label and description of a shared custom field on a single form without affecting how the field appears on other forms. Use overrides when the same underlying data point needs different wording per audience.Example: A shared Department field can show as “Your department” on an employee-facing onboarding form and “Requesting department” on an internal procurement form, while still writing to the same field on every ticket.
1
Open the form
Go to Settings > Forms and select the form.
2
Edit the field
In the form builder, click the field’s title to rename it inline, or open the field’s menu and choose Edit to update the description.
3
Save
Changes save automatically. The override applies only to this form.
Clear an override to fall back to the field’s shared label or description. Overrides do not change the field’s key, type, options, or validation — only the displayed text on this form.
Preview impacted forms
When you edit a shared custom field, Ravenna asks you to confirm the change and lists every form the field is attached to. When you try to delete a shared field that’s still in use, the error dialog shows the same list so you can see exactly where it’s referenced.Each entry in the list links directly to the affected form. The form you’re currently editing is labeled Current and is not clickable. Use this list to:- Review which forms will be affected before saving a label, description, or option change.
- Jump to other forms that need follow-up edits.
- Locate every form that still references a field you want to delete.
Use custom fields
Once you’ve created custom fields and assigned them to :Ticket creation- Users see custom fields when creating tickets with that form
- Custom field values appear in ticket details
- In table views, custom field columns are hidden by default. Show them from the column visibility menu.
- URLs in text and textarea fields are automatically converted to clickable links, including
https://,http://,www., and bare domain formats
- Custom field values can be updated after ticket creation from the ticket details page
Learn more about setting up forms and assigning custom fields to create complete ticket templates