Project administrators guide

Some of the features here might be unavailable for you. Please contact your Jira administrator if you think it should be available.

In this page

Where to find

To use Administer Fields for Project's features you have to be a project administrator at least in one project of the Jira instance.

To Access the Administer Fields for Project's dialog:

  1. Access the relevant project.
  2. Go to .
  3. Click on the Administer Fields button Under Components:
  4. A dialog similar to this one should open:
  5. You're good to go!


Create Field

In this tab you can create a new field for your project by following these steps:

  1. Enter the field name and type. Note that you can't add a field with the same name as an existing one.
  2. If you choose a select field to add (e.g. Select List (Single)), an Options text box will open, add your options there.
  3. You can also add a description to your field and limit the use of this field for specific issue types.
  4. If you want to create multiple fields, make sure the checkbox is checked.
  5. Hit the  button to create the field.
  6. You should get this flag:
  7. The field was created with a context only for this project, this means that it won't appear on any screen for issues that are not in the project. Learn more about Field Contexts in Atlassian Documentation.
  8. Make sure to add the field to the screens at Update Screen tab.
  9. If you added a field with options (e.g. Select List), you can add more options to it at Update Options tab.


Supported Field Types - Create Field

  • Checkboxes
  • Date Picker
  • Date Time Picker
  • Group Picker (mutiple groups)
  • Group Picker (single group)
  • Labels
  • Number Field
  • Project Picker (single project)
  • Radio Buttons
  • Select List (cascading)
  • Select List (multiple choices)
  • Select List (single choice)
  • Text Field (multi-line)
  • Text Field (read only)
  • Text Field (single line)
  • URL Field
  • User Picker (multiple users)
  • User Picker (single user)
  • Version Picker (multiple versions)
  • Version Picker (single version)
  • + More field types 

Show Field

In this tab you can show a field that is hidden by its Field Configuration by following these steps:

  1. Select the field you would like to show. Only fields that are hidden for at least one issue type will be available in the list.
  2. Select the issue types you would like to show the field for. (warning) Note that you can impact other issue types if they use a shared Field Configuration.
  3. If you want to show multiple fields, make sure the checkbox is checked.
  4. Hit the  button to show the field.
  5. You should get this flag:

Hide Field

In this tab you can hide a field that is shown by its Field Configuration by following these steps:

  1. Select the field you would like to hide. Only fields that are shown for at least one issue type will be available in the list.
  2. Select the issue types you would like to hide the field for. (warning) Note that you can impact other issue types if they use a shared Field Configuration.
  3. If you want to hide multiple fields, make sure the checkbox is checked.
  4. Hit the  button to hide the field.
  5. You should get this flag:


Update Options

In this tab you can edit options of a select field (see supported fields in the right) by following these steps:

  1. Check Existing Field checkbox if you want to edit options of a field that has context to this project, or New Context for Field checkbox if you want to add a new context to a field.
  2. Select the field you would like to edit its options. Only fields with types from the supported types will appear in the list.
  3. If the field is a Select List (cascading) type, check Option checkbox to edit the parent options, or Sub Option to edit the sub-options.
    1. (warning) If you want to edit sub-options, you have to pick a parent option to edit its sub-options.
  4. Enter new options in the New Value text box. Note that you can't add an option with the same name as an existing one in the field.
  5. Sort the options with the button or with drag and drop.
  6. Edit an existing option by changing its value in the Option Value column. Enable/disable an option by clicking on the button.
  7. If you want to edit multiple fields, make sure the checkbox is checked.
  8. Hit the  button to save the options.
  9. You should get this flag:


Supported Field Types - Add and Delete Option

  • Checkboxes
  • Radio Buttons
  • Select List (cascading)
  • Select List (multiple choices)
  • Select List (single choice)

Update Screen

In this tab you can update a screen (see supported fields in the right) by following these steps:

  1. Select the screen you would like to update.
  2. Editing the tabs on the screen:
    1. You can add a new tab to the screen using the + button 
      Enter the new tab name and hit the  button.
    2. You can edit tab name using the pen symbol 
      Enter the new tab name and hit the  button.
    3. You can change the order of the tabs by grabbing the three vertical lines  and drag the tab to its new location.
    4. You can delete a tab by using the X button , just remember that when you delete a tab you also remove from the screen all the fields inside it.
      (warning) You can delete a tab only if it was added inside the project using Administer Fields For Project. If the tab was added by a Jira administrator or from another project, the tab can't be deleted.
  3. Editing the fields on the screen:
    1. You can add a new field to the screen using the select list in the button, just select the field you want to add and hit the Add button.
    2. You can change the order of the fields by grabbing the three horizontal lines  and drag the field to its new location.
    3. You can delete a field from the screen by using the X button .
      (warning) You can delete a field only if it was added inside the project using Administer Fields For Project. If the field was added by a Jira administrator or from another project, the field can't be deleted.
    4. You can sort all the fields in a tab alphabetically by one click - . The summary field will remain first.
  4. If you want to update multiple screens, make sure the checkbox is checked.
  5. All changes in the screen are saved automatically.