Skip to main content

FieldCraft settings

This page lists the settings on FieldCraft's Settings tab, and what you find on the Help & support tab.

Both tabs are on the FieldCraft admin page: Settings (βš™) > Marketplace apps > FieldCraft: Custom Fields.

Only Jira admins can open it.

Calculation​

In the Settings tab, select Calculation.

These settings apply to every calculated field on your site.

SettingWhat the app saysDefault
Recalculate when work items change"FieldCraft updates values on the server whenever a work item changes, so search, boards, dashboards and exports stay current. Off: values update only when someone opens a work item, and when you reindex."On
Update parents and children"When a sub-task changes, counts and progress on its parent update too. When a parent changes, Parent Field values on its children update, and further down when a field reads a grandparent or higher."On
Refresh time-based values every hour"Time in status, time between and countdowns stay current in search and exports, in working time on each field's calendar."On

The last two work only while Recalculate when work items change is on.

While it's off, they show as off and you can't change them. When you turn it back on, they return to how you left them.

You see Saved after each change.

Work item views pick up a change within 30 seconds.

What each setting covers​

  • Recalculate when work items change is the main switch. When it's off, the Calculation tab shows Background calculation is off.

  • Update parents and children also covers Rollup totals and fields that read linked work items.

  • A Parent Field that shows a grandparent's value reaches the grandchildren too, so it's more than one level.

  • Refresh time-based values every hour also moves Countdown values.

  • Older values refresh less often. See Hourly refresh.

Jira API budget​

Below the settings, FieldCraft says: "FieldCraft uses at most 10,000 Jira API points an hour for background work on this site, so one busy site never slows others. It's fixed, not a setting. Work that doesn't fit waits for the next hour."

See Hourly calculation budget.

Work calendars​

In the Settings tab, select Work calendars.

You see your calendars with their time zone and total working hours per week.

From here, you create, edit and delete calendars. See Create a work calendar and Work calendars.

Help & support​

The Help & support tab answers common questions and connects you with the team that builds FieldCraft.

  • Common questions sit in three groups: Values, Fields and Work calendars.

  • Each answer has a button to the tab where you fix it.

  • Guides link to pages on this site.

  • Contact support and Suggest a feature open the support portal.

  • What's new shows the latest features, with a link to What's new.

Copy diagnostics for a support request​

Under For your request, you see the app's Version and Environment, the number of Calculated fields and Work calendars, and whether Background calculation is on.

  1. Select Copy diagnostics. You see Diagnostics copied.

  2. Paste the details into your request on the support portal.

Select Show details to see what you copy.

It holds the app version, the calculation settings, your browser's date and time format options, and your work calendars.

It holds no work items or field values.