Field context configuration


What is a field context?

In Jira, every custom field has one or more contexts. A context defines which projects and issue types the field applies to. By default, a new custom field has a single Global context that covers all projects and issue types.

You can create additional contexts to scope a field to specific projects or issue types. For example, you might have one context for “Project A, Bug type” and another for “All other projects.”


How contexts work with Stopwatch Field

Each field of the app (Stopwatch, Calendar Select) is a standard Jira custom field. To make it calculate values, you need to bind each field context to a field setting.

The relationship is:

Jira custom field
  └── Field context (scope: projects + issue types)
        └── Field setting (calculation rules)

One field setting can serve multiple contexts. For example, you can create a single “Cycle Time” stopwatch setting and bind it to contexts across several projects.


Configuring a field context

Step 1: Open the field’s context list

  1. Go to Jira Settings > Issues > Custom fields
  2. Find your Stopwatch field in the list
  3. Click … (more actions) > Contexts and default value

You will see a list of all contexts for this field.

Configure custom field page in Jira admin with the Custom field config row and the Edit custom field config link inside the context block

Step 2: Open context configuration

In the list, find the block of the context you want to configure. Open its Custom field config section and click Edit custom field config. Jira opens a page titled Edit custom field config: <field name> - this is the Stopwatch configuration panel provided by the app.

The context name itself is not a link - the app panel is only reachable through Edit custom field config, or by opening the URL directly:

https://<your-site>.atlassian.net/jira/settings/issues/field/{fieldId}/context/{configurationId}/configure/app

Both IDs are visible in your browser’s address bar while you are on the context list page.

Step 3: Select or create a field setting

The configuration panel lets you:

  • Select an existing field setting from the dropdown - choose a setting you have already created in the admin panel
  • Create a new field setting - opens the admin panel to create a new setting, then returns to bind it

Once a field setting is selected and saved, the app will start calculating values for all issues in this context.

A field setting that is not bound to any context is marked in its row in the admin panel with Not bound to a field context - nothing is calculated and an Open Health Check button; the Health Check tab lists all such settings, and the Recalculation tab lists unbound contexts.


Automatic context sync

The app automatically detects when field contexts are created, updated, or deleted in Jira. When you:

  • Create a new context - the app registers it and waits for you to bind a field setting
  • Update a context (change projects or issue types) - the app adjusts which issues are recalculated
  • Delete a context - the app cleans up the binding and stops calculating for the removed scope

Tips

  • Start with the admin panel: create your field settings, calendars, and events in the admin panel before configuring contexts. This way you will have settings ready to bind.
  • One setting, many contexts: reuse the same field setting across multiple contexts to keep configuration consistent.
  • Check recalculation: after binding a new context, go to the Recalculation tab to monitor progress and trigger a backfill for existing issues.
  • Orphaned contexts: if a field is deleted from Jira but its context data remains, use the Recalculation tab to clean up orphaned entries.