The value of this read-only custom field is dynamically calculated from a custom mathematic or numeric expression.

It can be used to obtain a numeric value depending on the value of other fields in the current issue or in any other issues (linked issues, sub-tasks, epics, stories, JQL selected issues, etc).

Configuration

Smart fields can be configured in two different ways. You can either use the Template view to choose from a set of preconfigured templates from our use case library, or you can switch to the Expert mode where calculations can be configured freely with our expression editor, best known from our Jira app Jira Workflow Toolbox (Cloud).


The Template view is the default configuration view of Smart Fields for Jira. It provides a set of preconfigured templates which are represented by cards. Each card shows a short name describing its purpose and the icon of the template category. 


From here, you can switch to the Expert mode at any time. If you had selected a template, its configuration is taken over to the Expert mode, where you can alter the corresponding parser expression. Be aware that you cannot switch back to the Template view once you have made any changes in the mode, even if you reverse them.

Select a use case from Template

Select a use case by clicking on a template card in the overview, or by clicking on Select at the button of the card. The selected card will be highlighted.

You can also search for templates by name or drill down in the overview by selecting a specific category, only showing templates from this category.

Some templates require more setup, like picking the source fields for your calculation. Based on the template you choose for your situation, you might need to click Next in the bottom right corner. 

For instance, if you want to calculate the "total story point of an issue within an epic", you will need to pick the field that contains your story points.

Click Save in the bottom right corner to finish your configuration.

The Expert mode allows you to configure custom Smart fields with the expression editor, best known from our best-rated Jira app Jira Workflow Toolbox (Cloud). You are free to edit the entire expression down to the logical elements.

You can choose a card from the Template view, switch to the mode and edit the underlying expression of this template, but you cannot switch back to the Template view once you have made any changes, even if you reverse them.

Select "Expert mode"

From the Template view, click the Expert mode button in the top right corner.

Enter a valid Expression

Need some inspiration? We have prepared some really helpful use cases and expressions for you. Check them out here: Use case library

Want to learn more about Expressions? Check out these pages: Expression Parser & Jira Expressions

Select display format 

Optionally, choose a custom display format. This is extremely useful to enhance usability for end users.

Read more about the available Display formats.

Click Save in the bottom right corner to finish your configuration.

Use cases and examples