Skip to main content
Version: 1.0.1

Field Configuration

This is where you define the specific behavior and appearance of your Issue Picker field. You can access this page by clicking Configure for any field in the Main Panel.

The configuration page is divided into two main tabs: General and View.

General Tab​

This tab controls the main functionality of the field.

  • Field Name and Description: These fields are read-only here and display the name and description you set when creating the custom field.
  • Note: An optional text area where you can add an additional note or instruction for users. This note is stored separately from the standard field description.
  • JQL Filter (Optional): This is a powerful feature that restricts which issues can be selected in the field. The JQL you enter here is combined with the user's search.
    • Example: If you set the filter to project = "PROJ" AND status = "To Do", users will only be able to search for and select issues that are in the "PROJ" project and currently have the "To Do" status.
    • Live Validation: The editor provides feedback as you type. A green checkmark indicates valid JQL, while a red error icon will appear if there is a syntax error.
  • Ignore Context: Allows the selection of issues from any project the user has access to, ignoring the field's native context (its project and issue type settings). The user's viewing permissions are always respected.
  • Selection Type: This setting determines whether users can select one or multiple issues.
    • Single Selection: (Default) Users can only select one issue.
    • Multiple Selection: Users can select multiple issues.

general tab

View Tab​

This tab controls how selected issues are displayed to the user on the "view" screen (read-only).

  • Visible Fields: You can choose what additional information to display alongside the selected issue's icon, key, and summary.

    • Required Fields: The Issue Type Icon, Issue Key, and Summary are always displayed.
    • Optional Fields: You can enable the visibility of:
      • Priority: Displays the issue's priority icon.
      • Assignee: Displays the assigned user's avatar.
      • Status: Displays the current status of the issue as a colored lozenge (e.g., "To Do", "In Progress").

  • Live Preview: This section provides a dynamic preview that updates as you check or uncheck the visibility options above. It gives you an immediate idea of how the field will look to your users. For example, the preview will show placeholder icons for priority and assignee, and a sample status lozenge.

view tab field

After making your changes on either tab, click the Save changes button to apply your new configuration.