Skip to main content

Create a field in Jira settings

Create a FieldCraft field of any type from Jira's fields page, when no recipe fits what you want to measure.

You create the field in Jira, add it to your spaces, and then configure it in FieldCraft.

Before you begin​

  • Jira permission: Jira admin (the Administer Jira global permission).

  • FieldCraft: installed, with an active license.

  • Pick the field type that fits your value. See Field types. You can't change a field's type later.

Create the field​

  1. Go to Settings (βš™) > Work items > Fields. Jira's fields page opens.

  2. Select Create new field. The Create field panel opens.

  3. In Field type, select the FieldCraft type, for example FieldCraft: Time Between. Every FieldCraft type starts with FieldCraft: .

    Jira's Create field panel with FieldCraft typed in Field type and the FieldCraft field types listed under Other fields

  4. In Name, enter the field name, for example Cycle time. You can use up to 255 characters.

  5. Optional: in Description, say what the field shows. Jira shows it next to the field.

  6. Select Create.

Jira creates the field.

Add it to your spaces​

Add the field to the field schemes or screens of the spaces that should show it.

  • For field schemes, go to Settings (βš™) > Work items > Field schemes.

  • For screens, open the Fields tab in FieldCraft and select Associate to screens in the field's β€’β€’β€’ menu.

Team-managed spaces choose their fields in each space's own settings.

Configure the field​

A new field calculates with its type's defaults until you save a configuration.

  1. Go to Settings (βš™) > Marketplace apps > FieldCraft: Custom Fields. The Fields tab lists the new field with a Not configured lozenge.

  2. In the field's β€’β€’β€’ menu, select Edit configuration. The field's configuration page opens.

  3. Choose the settings, and select Save.

Result: The field calculates on every work item that changes. To bring older work items up to date, use the Update suggestion on the Calculation tab. It also replaces values calculated with the type's defaults before you saved.

Jira expression, Rollup and Parent Field types also need you to acknowledge app access before they calculate.