Custom Fields

Custom fields allow you to add your own fields to issues and other objects in Redmine.
They are useful when you want to store information that is not covered by the standard fields.

For example, you might add a custom field named “Cause of defect” to the Bug tracker to classify the root cause of each software issue.

Creating a Custom Field

The following example explains how to create a custom field for issues.
We will add a field called “Cause of defect” to the Bug tracker to classify why a bug occurred.

1.　Open Administration → Custom fields.

2.　On the Custom fields screen, click New custom field in the upper right.

3.　Make sure Issue is selected as the object type, then click Next ».

4.　Enter the details of the custom field, such as its name and format, then click Create.

After creating the custom field, click Custom fields in the sidebar or at the top of the screen to return to the list.

If the custom field uses the Key/value list format, you will need to add the available options next.

1.　From the list of custom fields, click the name of the field you created to open its edit screen.

2.　On the edit screen, click Edit to open the page for managing available values.

3.　Enter each value and click Add to register it.
4.　After adding all the necessary values, click Save.

The custom field is now ready to use.

Types of Custom Fields

When creating a custom field, you must select a format, which determines the type of input the custom field accepts.
The following formats are available:

Format	Description
Key/value list	Allows selecting one item from a predefined list of values (dropdown).
Text	Accepts a single line of text.
Version	Allows selecting from the list of versions in the project.
File	Allows uploading a file.
User	Allows selecting from the list of project members.
List	A legacy option similar to Key/value list. For Redmine 3.2 and later, use Key/value list instead. Values cannot be renamed (only added or deleted).
Link	Same as Text, but the value is treated as a URL and displayed as a hyperlink.
Float	Accepts decimal numbers.
Integer	Accepts integer values.
Date	Accepts a date.
Boolean	Accepts a Yes/No value (displayed as a checkbox, dropdown, or radio button).
Long text	Accepts multiple lines of text. You can enable Wide display to match the width of the issue description field.
Progress bar	Allows entering a percentage value to visualize progress from a different perspective than the standard % Done field.