Troubleshooting and FAQ


Field shows no value / recalculation says “No field contexts configured”

Start with a check: Check an issue on the Health Check tab takes the issue key and names the first reason the field gets no value on it - from the list below.

Possible causes and fixes:

  1. Field setting is inactive - open the admin panel, find the field setting, and make sure the Active toggle is on.

  2. No field context binding - the Jira custom field must be bound to a field setting via its context. Go to Jira Settings > Issues > Custom fields, find the field, open Contexts and default value, then in the context’s block open Custom field config > Edit custom field config and verify a field setting is selected. See Field context configuration.

    You can spot an unbound setting in the admin panel: on the Time Between Dates tab its row is marked Not bound to a field context - nothing is calculated, with an Open Health Check button. The Health Check tab lists all unbound settings, and the Recalculation tab lists unbound contexts.

  3. JQL filter excludes the issue - if the field setting has a JQL filter, the issue may not match it. Check the JQL filter in the field setting and verify the issue matches.

  4. Issue date limit - if the field setting has an Issue Date Limit, issues created before that date are not processed.

  5. Recalculation needed - for existing issues, the app needs to process their changelog. Go to the Recalculation tab and run a recalculation for the affected context. For a single issue, choose Recalculate in the issue’s ••• menu - see Recalculate a single issue.

  6. Processing is paused - check the Recalculation tab for “All processing is paused”. If paused, click Resume all processing.

  7. The project is excluded from the app - if Jira rejects the app’s writes in a project, the app skips its issues entirely and they have no values. Check the Projects this app is excluded from section on the Health Check tab.

  8. The app license is inactive - see Admin shows “This app requires an active license”.


Admin shows “The app is getting ready”

Right after installation or an update the admin page may show The app is getting ready - The app is finishing its setup after installation or update. This usually takes about a minute. Nothing is wrong: click Refresh in a minute.


Admin shows “This app requires an active license”

The admin panel and the field context configuration page show This app requires an active license. Check the app license in Manage apps. instead of their content. Jira reports the app license as inactive.

What stops: the app does not recalculate or write field values - not on issue events, not in background sweeps, not in batch recalculation.

What keeps working: values already calculated stay on issues. JQL searches by values and the Calendar Select field keep working.

If Jira does not pass the license status at all, the app works normally - the notice appears only when the license is definitely inactive.

Fix:

  1. Check the app license under Jira Settings → Apps → Manage apps and renew it if needed.
  2. Run a Full recalculation on the Recalculation tab. After renewal the app does not catch up on the missed changes by itself.

Field values are not updating

Possible causes and fixes:

  1. Processing is paused - check the Recalculation tab for “All processing is paused”, and click Resume all processing. Counting of one context can also pause by itself when Jira does not complete its issue-count request several times in a row - the tab shows until when; Refresh on the context counts it now.

  2. Rate limits reached - if your instance generates a high volume of updates, the app may be throttled. Values will continue updating at a reduced rate. See Technical limits.

  3. Field is inactive - verify the Active toggle in the field setting.

  4. Scheduled refresh timing - some updates happen on a schedule (every 5 minutes or hourly) rather than immediately. For Time Between Dates fields in the Active state, the DateNextUpdate property controls when the next refresh occurs.

  5. Check freshness - go to the Recalculation tab and click Refresh on the relevant context to see current freshness statistics.

  6. One issue only - open the issue and use the Recalculate action in its ••• menu: it shows when each app field was last calculated and recalculates them on demand.


Calendar changes not reflected in values

After modifying a calendar (changing working hours, adding holidays, changing timezone), existing field values are not automatically recalculated.

Fix: Go to the Recalculation tab and run a Full recalculation for all contexts that use the modified calendar.


JQL search returns no results

Possible causes and fixes:

  1. Wrong syntax - Forge uses schema properties, not the Connect entity property syntax. The correct syntax is:
    "Your Field Name.PropertyAlias" operator value
    

    See Time Between Dates JQL for the correct syntax.

  2. JQL by a property finds nothing - check that the property alias is written inside the quotes of the field name, after a dot: "Your Field Name.SecondsValue" > 0. Jira answers a query with a wrong property with an empty result, not with an error, so an empty list does not mean that no issues match. To see the error, paste the query into the advanced search of the issue navigator.

  3. Case sensitivity - text property values (StateValue, DisplayValue) are case-sensitive. Use "Active" not "active".

  4. Field name mismatch - the field name in JQL must exactly match your Jira custom field name, including spaces and capitalization.

  5. Field has no value - if the field has not been calculated for any issues (no recalculation run), there are no values to search. Run a recalculation first.

  6. Wrong property alias - verify you are using the correct property alias from the documentation. For example, use TimeInHoursValue (not timeInHoursValue or TimeInHours).

Contact support

If you cannot resolve your issue with the steps above:

  1. Go to the admin panel and note the App version and Installation ID from the app info section
  2. Describe the issue, including:
    • What you expected to happen
    • What actually happened
    • The field type and setting name
    • The issue key where you see the problem
  3. Contact support through the Atlassian Marketplace or the app’s support channels