JIRA is now available as three separate applications, JIRA Software, JIRA Service Desk, and JIRA Core. For more information on administering these applications, refer to the Administering JIRA Applications documentation.

Adding a Custom Field

JIRA lets you add custom fields in addition to the built-in fields. When creating a custom field, you can choose between Standard and Advanced types. For standard types, a preview image is shown for each type, so you can see what you are creating in advance. This ensures that you get the custom field you want, much faster. To configure search templates or add contexts to custom fields, use the Configure option on each custom field.

JIRA ships with over 20 custom field types and you can find many more in the Atlassian Marketplace (e.g. the JIRA Toolkit). To build your own custom field types, see the tutorial at the JIRA Developer Documentation.

Custom fields are always optional fields. This means that you can create a new custom field without requiring existing issues to be changed. The existing issues will contain no value for the new custom field, even if a default value is defined.

Adding a field directly to an issue

JIRA Admins can add an existing field or create a custom field while in View Issue with the Admin > Add field option. You can even configure the options for that custom field without having to leave the screens you are presented with.

See this page for instructions on adding a field from View Issue: Adding a field to an issue.

Adding a field using the Add Custom Field button

  1. Log in as a user with the JIRA Administrators global permission.
    Choose > Issues. Select Fields > Custom Fields to open the Custom Fields page.
    (tick) Keyboard shortcut: g + g + start typing custom fields
  2. Click the Add Custom Field button. The following dialog is displayed:

    By default, this dialog displays the Standard, or most common, choices for custom fields. Click on the Advanced option in the left navigation or use the search box if you don't see the field you are looking for right away.
  3. Select a field and click the Next button.
  4. Configure the selection criteria for your field, as shown in the example below:

    (info) The Field Name will appear as the custom field's title in both entering and retrieving information on issues, whereas the Field Description is displayed beneath the data entry field when entering new issues and editing existing issues, but not when browsing issues.
  5. Click the Create button when you are ready. You will be presented with a dialog that displays your field, in context, and you can select the display options at this point:

    Anything you select here will be displayed in the issue you are editing.
  6. Click Submit to finalize the process. You will now see your new custom field and selected criteria displayed in the issue, as shown here:

Next steps

If you wish to change the context or other variables in your custom field, see Configuring a Custom Field.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

56 Archived comments

  1. User avatar

    Kjartan Jónsson

    Labels are great, but:

    I added a custom field "System Component/s" of type Labels. In "Choose applicable issue types" I specify a few Issue Types and in "Choose applicable context" I select a specific project, i.e. this is NOT a global field. However, the field "System Component/s" is visible in ALL projects when I browse any project's labelled issues:

    Field: Labels | Epic/Theme | System Component/s

    So this custom field seems to be global after all. Is there any way around this?

    27 Jan 2011
    1. User avatar


      What you tried to do was to create a "Context" which links an issue to a Project, I do not have my litterature on me at the moment so I am not sure what happened. You appeared to do that but go back and double check. Also if this does not work create a custom screen and a screen scheme. This should work.


      11 Jun 2012
  2. User avatar

    Sandro Franchi

    Regarding this feature (issues custom fields) an important point to remark, and unclear in the documentation (at least to me), is that custom fields can not be added to the projects screen, I mean, custom fields can't be added to a project (i.e. to state the total price of a project, the client to be billed, etc.).

    I saw lot of questions regarding this, and this was confirmed by Attlasian support, a "must be" feature (to custimize the project itself, not the individual issues of it) is not yet available.

    04 Feb 2011
  3. User avatar


    Is it possible by any way to give rights to the user/owner of project (other than global admins) to add custom filed within his project?

    Or to configure the custom field like adding values to it etc?

    10 Feb 2011
    1. User avatar


      Yes create a group and link it to the project role project_administrator. Then assign to the project role the project administration rights. This should work. I do not explicitly know if creating custom field rights is explicitly reserved for Jira Admins. This could be the case, which would mean there was nothing you could do and would have to give the project leader these rights. However I do not believe this to be the case. Also check permission rights scheme.

      11 Jun 2012
  4. User avatar


    Is it possible to add custom fields at the project or user level, say you wanted yo add a "Project Owner" field to the project.

    Thank you.

    24 Apr 2011
  5. User avatar


    Is it possible to change the field type of a custom field later??

    For example: textfield (<255 characters) into free text field (unlimited text).

    19 May 2011
  6. User avatar

    Bjorn Andersson

    It would be a great feature if you could allow project admins to perform select Jira admin functions such as managing the option list of a custom select list without having to grant jira administrator permissions.

    23 Aug 2011
  7. User avatar


    Agreed - having to grant full admin privileges to work with custom fields is less than ideal to say the least. We have a lot of users who want to manage their own custom fields so either i have to rant admin priv's to them (not ideal) or do it for them (even less ideal).

    26 Aug 2011
  8. User avatar


    Is there a way to create a custom field for Project overview and not assigned to Issues?

    05 Sep 2011
  9. User avatar


    Where's the regular ol' boolean checkbox?

    19 Oct 2011
  10. User avatar


    Is it possible to link a new Custom field to existing issues ?

    08 Nov 2011
    1. User avatar


      I am also interested in this. I added a tester field to a large backlog of issues however the field is only available to new issues created after the tester field was added.

      01 Nov 2012
  11. User avatar


    Hi Document Experts @ Atlassian,

                                                       Just to let you know that the when you add any custom field (especially a select list / radio button ) there is another option added to the screen not the field which is "NONE" even make sure that you have a option to specify how to remove that if not needed from the screen.


    11 Mar 2012
    1. User avatar

      Giles Gaskell

      Hi there,

      If you're attempting to point out something that should be clarified in the documentation above, could you please be clearer about what you mean by:

      ...there is another option added to the screen not the field which is "NONE" even make sure that you have a option to specify how to remove that if not needed from the screen.

      (It would also help if you could quote the section of text in the documentation above that needs improvement.)

      Kind regards,


      22 Mar 2012
  12. User avatar


    Did you correct the limitation of one context by projet ie i want to use a context for an issue type in a project and another context for another issue type in the same project?


    21 Mar 2012
  13. User avatar

    Karie Kelly

    We are an OnDemand user and have the custom field type of multi-issue key searcher.  I don't see this in the list above and was wondering how to use it? I tried to use it and add the field I created to the screen. But, the field would never display on the screen - consequently, I couldn't figure out what it was or how to use it correctly. Please advise.


    27 Apr 2012
  14. User avatar

    Kevin McClennen

    I am trying to make a custom field but only have a select group be able to view it.  For example: I made a field for our dev's to add a link to.  We do not want our clients to see this link though.  I have only been able to make it so both people see the field or neither see the field.

    I assume this is possible but have had no luck reading though this documentation.  If someone could point me in the right direction I would GREATLY appreciate it!



    Kevin McClennen

    11 May 2012
    1. User avatar



      I believe you can do this by creating a Field Configuration Scheme. This is slightly complicated but should work.You have to create two field configuration naming each. One scheme will be for your developers and one will be for your clients. The configuration defines which fields of information are shown and which one are "invalid" aka invisible, so one configuration will have the link shown (I am assuming the link is either seen in a description or you created a cusom field for it) and one configuration where the link (the field where it is posted) is hidden. Then you need to create a field configuration scheme which will link one of the configurations (so link shown or not shown) to a group in this case employees versus clients. It is the combination of Both that works. This is rather complicated and I quite frankly dont think the Atlassian website is organized very conherently. That being said I recommend a book called JIRA 4 Essentials by Patrick Li. The book is very thorough and was of great help to me.

      11 Jun 2012
  15. User avatar


    Is there any way to validate the format of a custom field, say using a regex etc? e.g., suppose I need to add a reference field to another system that MUST consist of the letter "H" followed by an integer number....

    Not sure where to go on this...


    15 May 2012
  16. User avatar

    Amir Khalilian

    I added a radio button control to my screen with button "yes" and "no". But there is also a 3rd "None" button which I didn't add.

    How do I get rid of this magical "None" button?

    14 Jun 2012
    1. User avatar


      Make the custom field a required field in the "Field Configuration" which applies to your project / issue tyep. Then the "None" button will not be available.

      08 Feb 2013
      1. User avatar

        aurobindo dash

        Thanks mate!!

        Worked fine for "Radio Button".

        Any idea what needs to be done for "Select List"?

        02 May 2014
      1. User avatar

        Dave Scheet

        This makes the field required at issue creation.  We want to have a radio group that isnt used until later in the workflow


        07 Jan 2015
  17. User avatar

    chris hall

    We use the built-in and number fields and have custom Number Fields and we want to see a total on screen of all the filtered data.  How can we do this ? I have heard a rumour of the totalfielddecorator but no info found on the JIRA docuemntation.


    20 Jun 2012
  18. User avatar

    Joseph Faill

    I need to add a field that will appear for each individual issue. It needs to be a Yes/No field called "Response Required." And only one or the other can be selected. Which field type would I need to do this?

    06 Jul 2012
  19. User avatar


    Is there any way to filter out some versions in a version picker?  I would like to be able to limit the list to only ones that make sence for the context you are in.  For example only version for a specific release, or only unreleased versions.  We also use versions to designate the sprint so I would like to only show sprint versions in one case

    31 Aug 2012
  20. User avatar

    Eva Graf

    I would like to insert a couple of fields (e.g. Names of a customer, company and phone number). Then, when creating a new issue, the user should be able to pick a name out of the list and automatically, all the other values are shown as well. I want the users to be able to edit these customer informations as well. How can I create such fields?

    14 Sep 2012
  21. User avatar


    I am unable to set the default value for select field in JIRA 4..4.5. It is showing all the statuses(Open,InProgress....) but by selecting them they are not configured as default values.The same has worked correctly with JIRA 4.1.2.


    Also the methods are  returning null values .

    public Object getDefaultValue(final FieldConfig fieldConfig) {
    Object object = genericConfigManager.retrieve(
    CustomFieldType.DEFAULT_VALUE_TYPE, fieldConfig.getId()
    LOG.debug("<<object value is null in getdefaultvalue()");

    return object;



    private Object getDefaultStatuses(CustomField field) {

    try {
    FieldConfigSchemeManager sm = (FieldConfigSchemeManager) ComponentManager
    long fieldConfigId = ((FieldConfigSchemeImpl) ((List) sm
    Object list = genericConfigManager.retrieve(
    LOG.debug("<< the list in getdefaultstatuses() is empty");
    return list;

    } catch (NullPointerException npe) {
    return new ArrayList<String>();


    I hope the problem is with this.how to solve this please help me .


    Thanks in advance.




















    28 Nov 2012
  22. User avatar


    I would like to create a derived field, when an issue is created with 2 fields selected, this field should be calculated based on the selections on the other 2 fields. How can I do that?

    07 Dec 2012
  23. User avatar


    Can custom fields only be added against issues, or can they be applied to other types as well.  I'd like to be able to have a custom field stored at the Project level, or even better, at the Version level.  Is this possible?

    18 Dec 2012
  24. User avatar


    How to create user defined fields?

    For example: I want to create a field called "Trade off" then how do I do it? Using custom field option I cannot create fields I want for my project.


    10 Jan 2013
  25. User avatar

    murali krishna

    How to create user defined fields?

    For example: I want to create a field called "Trade off" then how do I do it? Using custom field option I cannot create fields I want for my project.


    10 Jan 2013
  26. User avatar


    Dear Sir or Madam,

    it seems that it is not possible to add custom fields for "wiki-syntax" content (like "Description" or "Environment").

    Is this feature planned to be added in future releases?

    Is there a way to enable wiki-formatting for a custom field with the current (5.2) Version of JIRA?


    Kind Regards

    10 Jan 2013
    1. User avatar

      Bjorn Nelson

      You'll need to configure the "Renderer" for your custom field.  I tried this in version 6.0:

      1. Browse to JIRA Admin.
      2. Select Field Configurations.
      3. Locate your field configuration and select Configure.
      4. Locate your custom field and select Renderers.
      5. Update the renderer to Wiki Style Renderer.
      22 Jan 2013
      1. User avatar

        Stefan Andersson

        i don't have Wiki Style Renderer to choose, only Default text Renderer when i create a multi-line text-field.

        We have the latest version 6.2. 

        do I need to do something in JIRA administration in order to be able to get the Wiki Style Renderer visible in custom fields?

        13 Jun 2014
        1. User avatar

          Warren Thompson

          Hi Stefan,

          Without having access to your instance I can't say exactly what the situation is, but I'd guess it could be that wiki style renderer is not enabled. If you follow the documentation here you should be able to enable it.



          16 Jun 2014
  27. User avatar

    David Kirchner

    14 Feb 2013
  28. User avatar

    Dave Lyubarsky

    I've created a Cascading Select field with a set of values, but when the drop-down lists appear on the screen there is a "None" option present.  Is there a way to remove the "None" value from the drop-down list?

    10 May 2013
  29. User avatar

    Amanda Ressler



    Is there a way to create custom search templates? We have multiple groups and I really only want to choose from 3 or 4 for my custom field instead of the 20+ available. Is this possible?


    21 May 2013
  30. User avatar

    Dieter Greiner

    Adding a custom field directly in the view screen is a good idea. What i still miss is a feature to do that change just for that particular Edit screen only eventually causing screen, screen scheme and issue type screen copies. Also it should be possible to place the field into  a specific configuration context during that Admin operation.

    02 Sep 2013
  31. User avatar


    Could you add a list of JIRAs custom field types? Not just "JIRA ships with over 20 custom field types". More details here would be very helpful.

    08 Nov 2013
  32. User avatar


    I am playing around with this feature but it looks like adding a field directly from the issue will only present you with global fields. Per best practices our fields are restricted based on issuetype and or project. 

    20 Feb 2014
  33. User avatar

    D G

    I don't see a way for an optional field to always be shown on a screen.  You have to set a default value for it to show up using some fictional value like "unspecified".  If the field is multi-valued, that means a user must delete the "unspecified" value when adding a real value.  Why can't the field be configured to always be displayed on a screen without requiring a value?

    01 Apr 2014
  34. User avatar

    Hannah Gilberg

    Is it possible to add a custom date field to the Fix Version? It doesn't matter if it's globally applied. 

    01 Jul 2014
  35. User avatar

    Bradley Ayers

    Hannah Gilberg you're able to add a custom date field to screens, yes. It's up to you to put conventions in place for how that field is used and how it relates to Fix Version.

    02 Jul 2014
  36. User avatar


    Anybody knows if it is possible adding a table custom field.

    I want to add a table with several columns, and see it as part of the issue. Is it possible? Thanks

    24 Jul 2014
  37. User avatar

    Anton Prokudin

    Hello, I have a problem. I have created a custom field with multiple choice of users. Administrators can to change it's value, but users with other project roles can't to change it. What can I do?

    19 Aug 2014
    1. User avatar

      Bradley Ayers

      Please ask on http://answers.atlassian.com, or raise a support issue on http://support.atlassian.com.

      19 Aug 2014
  38. User avatar

    karthik subbiah ravishankar

    can we add a mandatory custom field to our project??? If so how to add mandatory validation?

    07 Nov 2014
    1. User avatar

      Andre van Rossem

      Hi. I am also interested in a mandatory field. Is this solved? what's the solution?



      29 Dec 2014
  39. User avatar

    Jared Bownds

    I noticed the link for "Adding a field to an issue" re-routes back to this page.  However, is this in fact addressed in this tutorial?  Also, is there a solution that allows a custom field to be mandatory?


    30 Dec 2014
  40. User avatar

    zhao ninglong

    if i am a program administrator(not JIRA administrator) can i add a custom field?

    15 Jan 2015
  41. User avatar

    Walter Peterscheck

    Greetings. If we enable the user picker custom field, is there a way to "see" that user / users in the scrum board? I.e. right now the scrum board only shows the 1 person in the "Assignee" field, it would be nice, once we add the "User picker custom field" and add another user, if the scrum board would somehow indicate that another user is also working on an issue.

    Is this something that can be done?

    Thank you.

    15 Jul 2015
    1. User avatar

      Dave Scheet

      would going into the agile board configuration section and adding that field to the Card Layout work for you?

      15 Jul 2015
Powered by Confluence and Scroll Viewport