Page tree
Skip to end of metadata
Go to start of metadata

Jira allows you to add and modify all custom fields, including the SLA Metric field. In the Jira system, you can modify each of the custom fields by changing the following:

  • Name — the label that appears to the left of the custom field when it is displayed to a user. Read more
  • Description — the help text that appears below the custom field when it is displayed in the Simple Search column. Read more
  • Search Template — the mechanism that allows making the custom field searchableRead more
  • Default Value — the default value of the custom field displayed to a user.  Read more
  • Options (for Select and Multi-Select fields only) — the range of values from which users can choose. Read more
  • Context — the combination of a project(s) and issue type(s) for which a given Default Value and Options will apply. Read more
    (info) Tip: You can create multiple Contexts that allows you to set different Default Values and Options for different combinations of projects and/or issue types.
  • Screens — the screen(s) on which the custom field will appear when an issue is created, edited or transitioned through the workflow. Read more (also see Defining a Screen).
  • Renderers — see Configuring Renderers and Specifying Field Behaviour.
  • Hide/Show — see Specifying Field Behaviour.
  • Required/Optional — see Specifying Field Behaviour.

Viewing the SLA Metric field

To view the SLA Metric field in your Jira system:

  1. Log in as a user with the Jira Administrators global permission.
  2. Choose  > Issues. Select Fields > Custom Fields to open the Custom Fields page.
  3. Select SLA Metric from the list.

Editing the SLA Metric field

Editing the SLA Metric field allows you to change its Name (label), Description (Help text) and Searchh Template.

To edit a field:

  1. Navigate to the Custom Fields page (proceed as described above), locate the SLA Metric field and choose  > Edit:
    • The Name is the label that appears to the left of the custom field when it is displayed to a user.
    • The Description is the help text that appears below the custom field when it is displayed in the Simple Search column.

    • Search Templates are responsible for indexing a custom field as well as making it searchable via Simple Search and Advanced Search (note that custom fields are not searchable via Quick Search). Every custom field type has a predefined search template, but you may select a different template using this procedure.

  2. Modify the fileds as desired and click Update.

Configuring the SLA Metric field

The custom field context – also known as the custom field configuration scheme is not related to the field configuration scheme – it specifies the following options for the field:

You can create multiple contexts if you need to associate different default values and options with particular projects or issue types.

Each custom field has a context named Default Configuration Scheme for ... which is created automatically when you add your custom field.

Context

To change the project(s) and issue type(s) to which a given Default Value and Options apply:

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired field and choose > Configure.
  2. Locate the context named Default Configuration Scheme for ... and click the Edit Configuration link.
  3. Under heading Choose applicable issue types, select the issue type(s) to which you want this Default Value
     and Options to be applied. You can select Any issue types if you wish.
  4. Under heading Choose applicable contexts, select the project(s) to which you want this Default Value and Options to be applied. Note that this will apply only to issues with selected issue type(s) as above.

Adding a new context

Adding a new context allows you to configure a field differently for different combinations of issue types and projects.

To add a new context:

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired field and choose  > Configure.
  2. Click the Add new context link. The 'Add configuration scheme context' page will be displayed (see below).
    • Under the heading  'Add configuration scheme context', enter a 'Label' and 'Description' for your new context — these are used for administrative purposes only and will not be shown to end-users.
    • Under the heading  'Choose applicable issue types', select the issue type(s) to which you want this Default Value and Options to be applied. You can select Any issue types if you wish.
    • Under the heading  'Choose applicable contexts', select the project(s) to which you want this Default to be applied.

(info) Tip: A field can only have one context per JIRA project. So you cannot have multiple contexts for different issue types in the same project.

Choosing screens

To choose Screens on which a field will appear:

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired field and choose  > Screens.
  2. Select the checkboxes of the screens on which you wish to display this custom field.
    (info) Note that field visibility depends on the field configuration (which is not related to the custom field configuration scheme described above). Refer to Specifying Field Behavior for more information.

Translating a field

You can translate the name and description of any field that you create into another language. You can select only from the language packs installed in Jira.

To translate the field and the description of a custom field to another language:

  1. Navigate to the Custom Fields page (proceed as described above), locate the desired custom field and choose  > Translate.
  2. Choose the language pack that this custom field translation will belong to (e.g. French).