Custom fields¶

• Table of contents
• Custom fields
  • Custom field types
    • Format
    • Validation
    • Values
    • Text formatting
    • Link values
    • Input field styling
  • Custom field supporting data types
    • Fields for Issues
    • Fields for Spent time entries
    • Fields for Projects
    • Fields for Versions
    • Fields for Users
    • Fields for Groups
    • Fields for Activities (time tracking)
    • Fields for Issue priorities
    • Fields for Document categories

Custom fields allow you to add additional information to several types of data used in Redmine. See 'custom field types' for all types of data which come with support for custom fields.
Each custom field can be defined to be of a certain type.

Custom field types¶

Format¶

A custom field can be of one the following types:

• Boolean: checkbox
• Date: date
• Float: floating point number
• Integer: positive or negative number
• Link: URL
• List: drop down list
• Long Text: resizeable multiple lines of text (supports rich text formatting as of 2.50)
• Text: multiple lines text (supports rich text formatting as of 2.50)
• User custom field format that can be used to reference a project member
• Version custom field format that can be used to reference version

Validation¶

Some validations can be defined for each custom field:

• Min - max length: minimum and maximum length for the field (0 means that there is no restriction)
• Regular Expression: a regular expression can be used to validate the field content. Examples:
  1. 4 capital letters followed by one or several digits
     

     ^\[A-Z]{4}\d+$

  2. characters only, no digits
     

     ^[^0-9]*$

• A full list of regular expressions can be found in the Ruby Users Guide.

Values¶

Some field support multiple values and default values.

• Multiple values: while enabled, more than one item may be selected.
• Possible values: possible values for the "List" fields. One line for each value.
• Default value: default value to apply if none selected.

Text formatting¶

Some fields support text formatting.

• Text formatting: whether to wikify the text. If enabled, then locks the Link values to URL field.

Link values¶

Link values can be defined for boolean, date, list, integer and text format fields.

• Link values to URL: creates a URL using the following variables.
  • %value% => the custom field value
  • %id% => id of the customized object
  • %project_id% => id of the project of the customized object if defined
  • %project_identifier% => identifier of the project of the customized object if defined
  • %m1%, %m2%... => capture groups matches of the custom field regexp if defined

Example:

https://www.redmine.org/issues/%value%

Input field styling¶

(2.5.2+) Some fields may be displayed as radio buttons or checkboxes, with slightly different behaviour based on the selected "Format":

• Boolean: checkbox (enabled/disabled) or radio buttons (null/yes/no)
• List, User and Version:
  • checkboxes (if Multiple values is enabled)
  • radio buttons (if Multiple values is disabled)

Custom field supporting data types¶

Fields for Issues¶

Data in issue custom fields can be used and/or will be displayed in issues, issue lists, custom queries and the Timelog report.

• Trackers: TODO
• Required: field which is required in order to create/save an issue
• For all projects: if checked, this field is used for the issues of all the projects. If unchecked, each project can choose whether or not to use the field for its issues (see Project settings).
• Used as a filter: TODO
• Searchable: field which is searchable using the Redmine search function

Fields for Spent time entries¶

Data in spent time entry custom fields can be used and/or will be displayed in the Timelog report.

• Required: field which is required in order to create/save a spent time entry

Fields for Projects¶

Data in project custom fields can be used and/or will be displayed in the Project overview.

• Required: field which is required in order to create/save a project
• Searchable: field which is searchable using the Redmine search function

Fields for Versions¶

Data in version custom fields can be used and/or will be displayed in the Roadmap and the Version overview.

• Required: field which is required in order to create/save a version

Fields for Users¶

Data in user custom fields can be used and/or will be displayed in the user profiles.

• Required: field which is required in order to create/save a user
• Visible: field which is displayed in the user profile
• Editable: field which is editable by the Redmine user owning the user account

Fields for Groups¶

Note: group custom fields are not (yet) used in the Redmine core, though other plugins or themes can/may use them. No setting here has any effect on any other parts of Redmine for the time being.

Fields for Activities (time tracking)¶

Data in time tracking activity custom fields can be used and/or will be displayed¹ in the Timelog report and the Project settings. See also #4077 for some details about this nifty feature.

• Required: field which is required in order to create/save an activity

Fields for Issue priorities¶

Note: issue priority custom fields are not (yet) used in the Redmine core, though other plugins or themes can/may use them. No setting here has any effect on any other parts of Redmine for the time being.

Fields for Document categories¶

Note: document category custom fields are not (yet) used in the Redmine core, though other plugins or themes can/may use them. No setting here has any effect on any other parts of Redmine for the time being.

¹ there are some exceptions, see #19121#note-1.