Skip to main content

Hourly calculation budget

The hourly calculation budget is the Jira API work FieldCraft may do in the background on your site. It's 10,000 Jira API points an hour.

Knowing it helps you plan large reindexes and understand why some values wait.

Why there is a budget​

Jira limits how much one app may call it each hour, across all the sites that use the app.

FieldCraft gives each site its own share, so one busy site never slows FieldCraft down on yours.

How it works​

Background work costs points: recalculating after a change, updating parents, the hourly refresh, reindexes and some AI assistant requests.

FieldCraft estimates the points itself, because Jira doesn't report them.

A request that returns many work items costs more than one that reads a single work item.

The budget resets at the start of every hour, in UTC.

Reindexes use at most 60%​

A reindex uses at most 6,000 points an hour, 60% of the budget.

The rest stays free, so values still update when work items change while a large reindex runs.

The reindex dialog estimates the time for you from this share.

A first reindex assumes about 11 points per work item. Later estimates use what your site's reindexes cost.

Work itemsPointsEstimated time
3,000About 33,000About 6 hours
20,000About 220,000About 37 hours
50,000About 550,000About 4 days

What waits for the next hour​

You lose nothing when the budget runs out. The work waits and continues on its own:

  • Recalculations after a change wait until the next hour starts.

  • The hourly refresh stops and catches up at its next run.

  • A reindex shows Waiting for next hour's budget and continues in the next hour.

  • An AI assistant's preview or explanation skips the fresh calculation and says so. Ask again after the hour.

What is never held back​

Opening a work item never waits for the budget.

The work item view always calculates when it needs to.

The FieldCraft admin page also works as usual, so you can still check status and change settings.

See the usage​

  • On the Calculation tab, the This hour card shows you the points used, and the values recalculated, changed, failed and waiting.

  • The line below the card shows the same for the last hour.

  • On the Activity tab, the Points column shows what each refresh and reindex used.

  • While a reindex runs, its Points used shows on the Calculation tab.

You can't change it​

The budget is the same on every site. On the Settings tab, FieldCraft says: "It's fixed, not a setting."

If you need values sooner, narrow a reindex with JQL, or select Only work items without a value.