Skip to main content

Create a field from a recipe

Create a ready-made field from a recipe, and check its value on one of your work items before you create it.

A recipe is a field type with settings already chosen, such as Cycle time or Reopen count.

You can change every setting later.

Before you begin​

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

  • FieldCraft: installed, with an active license.

  • Some recipes need a work calendar, Jira Service Management, a story points field, the Sprint field or the Blocks link type. See Field recipes.

Pick a recipe​

  1. Go to Settings (βš™) > Marketplace apps > FieldCraft: Custom Fields, and open the Fields tab.

  2. Select New field from recipe. The recipe gallery opens.

  3. Select a category, for example Time spent, or type in Search recipes.

    The New field from recipe gallery with its search box, category buttons such as Time spent 11, and the first recipe cards

  4. Select a recipe card. The recipe form opens.

Each card shows the field type and a summary.

Added means you already made a field from this recipe.

Name in use means a field of the same type already has this name.

Fill in the form​

The form shows only the sections the recipe needs, and numbers them in order.

  1. Under Name the field, keep or change Field name. Add a Description if you like; Jira shows it next to the field.

  2. Under Statuses, check the statuses the form picked. You can pick Any To Do status, Any In Progress status or Any Done status to cover every status of that category.

  3. Under Working hours, select a work calendar. If you have none yet, select Create 8/5, Mon to Fri, 09:00 to 17:00 to create one in the time zone shown on the button (your Jira profile's).

  4. Under Check it on a real work item, enter a work item key and select Run preview. You see the value for that work item, and FieldCraft saves nothing.

    The Cycle time recipe with the 8/5, Mon-Fri, 09:00 - 17:00 work calendar and a preview of 22 days on a work item

  5. Under Show it on screens, select the screens where your teams should see the field. This step is optional.

  6. If you see Calculated with the app's access, read the notice and select its checkbox. See Acknowledge app access.

  7. Select Create field.

Until the form is complete, you can't select Create field.

The hint next to the button tells you what's missing.

Result: FieldCraft creates the field with one context for all spaces and work types, and says it's ready, for example Cycle time is ready.

What's next​

The success page lists what FieldCraft set up, and offers three next steps.

CardWhat you can do
Fill in existing work itemsSelect Fill last 90 days to calculate values on work items created in the last 90 days or still open. It runs in the background, so you can close the page
Use it in search and dashboardsSelect Open in search or Copy JQL to use the recipe's JQL example
Fine-tune itSelect Edit configuration to open Jira's context list for the field, or open the recipe's guide

To make another field, select New field from recipe.