An issue layout rule allows you to perform an action dynamically when a specified condition is met.
You can use these rules to customise your issue layout creation and updation form to suit different project needs.
Benefits
- Optimize your issue forms by viewing fields based on matching condition.
- Mandate specific fields based on value in another field.
- Create a customized flow using dependent layout rules. View a related drop-down based on the selection in a pick list.
Feature Availability: Enterprise Plan
Layout Rule Types
- Conditional Layout Rule - This rule allows you to change the properties of a field based on certain conditions. This type of rule can be executed when an issue is created or updated.
- For instance, if a user wants to set the due date for all the critical issues, they can create a conditional rule by setting a condition where Severity is marked "Critical". Once the condition is created, they can choose Set mandatory field action to add the due date for the issue.
- Dependent Layout Rule - This rule allows you to view specific field values based on a value selected in another field. User can set this type of rule to display only the relevant fields in an issue form.
- For instance, if a user wants to fetch the browser details for all UI-related issues, they can set the categorise the issues by setting a primary field and get the details about the browser in the secondary field.

Create Layout Rule
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields > Issues > Layout Rules.
- Click New Layout Rule in the upper right corner.
- Enter the Rule Name, Description, and choose an existing Layout. If there are not any created layouts, the system will only list the default layout in the drop-down.
- Select the Rule Type and create a rule.
- Conditional Layout Rule: Use the conditional layout rule to change the property of a custom field.
- Dependent Layout Rule: Use the dependent layout rule to change the value of the custom picklist fields.
- If you have selected Conditional, choose the trigger to Execute On; Choose a condition to initiate Rule. If you have selected Dependent, choose the Primary Field and the Dependent.
- Click Save.
If the Rule Type is Conditional and the condition field is set to 'Is updated,' you can only add 'Set Mandatory Field' as an action.
If multiple conditions are set, the first matching condition and its corresponding actions will be executed. The subsequent conditions will not be checked.
Edit Layout Rule
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields > Issues > Layout Rules tab.
- Hover over a layout rule and click
to view options.
- Click Edit.
- Modify layout rule information.
- Click Save.
Delete Layout Rule
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields >Issues > Layout Rules tab.
- Hover over a layout rule and click
to view options.
- Click Delete.
- Confirm your action.
Layout Rule Actions
Once a condition is created, the user can add actions like showing fields, showing sections, or enabling/disabling mandatory fields.
Show fields
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields >Issues > Layout Rules tab.
- Click on the rule which you would like to add action.
- Click Add action and select Show fields.
- Select the fields you would like to display.
- Click Save.
Show sections
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields >Issues > Layout Rules tab.
- Click on the rule which you would like to add action.
- Click Add action and select Show sections.
- Select the sections you would like to display.
- Click Save.
The default section will not be displayed under "Show sections".
Set mandatory fields
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields >Issues > Layout Rules tab.
- Click on the rule which you would like to add action.
- Click Add action and select Set Mandatory Fields.
- Select the fields which you would like to set as mandatory.
- Check the Clear the current value and prompt for a new value when triggered checkbox if you want to prompt for new values for the mandatory fields.
- Click Save.
The Clear the current value and prompt for a new value when triggered checkbox will be only available when the condition field is set to 'Is updated'.
Remove mandatory field
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields > Issues > Layout Rules tab.
- Click on the rule which you would like to add action.
- Click Add action and select Remove Mandatory Field.
- Select the mandatory fields which you would like to remove.
- Click Save.
Disable field
- Click
in the upper-right corner of the top navigation band.
- Navigate to Customization > Layouts and Fields > Issues > Layout Rules tab.
- Click on the rule for which you would like to add action.
- Click Add action and select Disable Field.
- Select the fields which you would like to disable.
- Click Save.
If a field is set as mandatory, it cannot be disabled.
Limitations:
- A layout rule can have a maximum of 35 conditions
- Users can add upto 200 conditions per layout.
- There is no restriction on the number of rules that can be associated with a single layout, however, the above restrictions must be satisfied.