Skip to main content
Custom fields let you add additional information fields to your ticket creation forms. They work with forms to create dynamic, customized ticket templates that capture exactly the information your team needs.
Introduction

How Custom Fields Work

Custom fields are tied to specific forms. When someone creates a ticket using a particular form, they’ll see both the standard system fields (like title and description) plus any custom fields you’ve configured for that form. For 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. To learn more about forms and how they work, see our Forms documentation.

Custom Field Types

Ravenna supports 9 different types of custom fields to capture various kinds of information:

Text

Single-line text input for short responses

Text Area

Multi-line text input for longer descriptions

Number

Numeric input with validation

Date

Date picker for scheduling and deadlines

Boolean

Yes/No checkbox

Select

Single-choice dropdown menu

Multi Select

Multiple-choice dropdown menu

User Select

Choose from organization members

Application Select

Select from applications connected to organization

Creating Custom Fields

Introduction
There are two ways to create custom fields in Ravenna:

Method 1: Through Settings

  1. Navigate to Settings > Fields in your workspace
  2. Click Create Custom Field
  3. 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 the 9 available field types
    • Required: Toggle whether this field must be filled out
  4. Click Create to save your custom field

Method 2: Through Form Setup

Introduction
You can also create and manage custom fields directly within forms:
  1. Navigate to Settings > Forms
  2. Select an existing form or create a new one
  3. 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 custom fields using the dropdown menu in each custom field item
Introduction
  1. Make fields private by toggling the private option - this makes the custom field visible only for the current form

Using Existing Custom Fields

Introduction
Existing custom fields are non-private custom fields that were created from other forms previously or from settings. You can find them in the Existing Custom Fields tab in the right panel of the form builder. These custom fields are shared across forms, meaning you can reuse them in multiple forms without recreating them.
When you update an existing custom field that’s shared across multiple forms, the changes will apply to all forms that use that field.
Custom fields cannot be deleted when they are being used in a form.

Using Custom Fields

Introduction
Once you’ve created custom fields and assigned them to forms:
  1. Ticket Creation: When users create tickets using that form, they’ll see your custom fields in the form
  2. Ticket Display: Custom field values appear in the ticket details
  3. Ticket Updates: Custom field values can be updated after ticket creation from the ticket details page

Best Practices

  • Use descriptive labels that clearly explain what information you’re collecting
  • Add helpful descriptions to guide users on what to enter
  • Mark fields as required only when the information is essential
  • Choose appropriate field types to ensure data quality (e.g., use Number fields for numeric data)
  • Test your forms after creating custom fields to ensure they work as expected

Forms

Learn how to set up forms and assign custom fields to create complete ticket templates