Skip to main content

Quick Start Guide

Create your first Dynamic Screen Rules rule in under 10 minutes with this step-by-step tutorial. You'll learn the basics by building a practical rule that shows a field only when specific conditions are met.

info

⏱️ Time to complete: 10 minutes | 🎯 Difficulty: Beginner | 📚 What you'll build: A progressive disclosure rule

What You'll Build​

In this guide, you'll create a rule that demonstrates progressive disclosure - one of the most common use cases for Dynamic Screen Rules.

tip

The rule: Hide the "Root Cause" field for Bug issues when Priority is High.

Why this is useful: This rule keeps your create issue screen clean by hiding the Root Cause field for high-priority bugs. The field remains visible for lower-priority bugs where detailed root cause analysis might be needed during initial triage.

What You'll Learn​

Configuration AccessHow to navigate to the Dynamic Screen Rules configuration panel in your Jira project
Rule CreationHow to create a new rule with screen selection and target field configuration
Scoping RulesHow to limit rules to specific issue types (Bugs, Stories, etc.)
Field ConditionsHow to add field-based conditions that trigger when values change
Testing RulesHow to verify your rule works correctly in real-time
info

Before you start: Make sure Dynamic Screen Rules is installed in your Jira instance. See Installation & Setup if you haven't installed it yet.

Prerequisites​

warning

Before you begin, make sure you have the following:

  1. Project Administrator permissions in any Jira project
  2. A "Root Cause" field added to your project's create screen
    • This can be any text field or paragraph field
    • If you don't have this field, you can use any other field for practice
  3. Bug issue type available in your project
  4. Dynamic Screen Rules installed (see Installation & Setup)
tip

Don't have a Root Cause field? No problem! You can follow this tutorial using any field on your screen. The principle is the same - you're learning how to show/hide fields based on conditions.

Creating Your First Rule - Step by Step​

    1. Open the Jira project where you want to create the rule
    2. Click Project Settings in the left sidebar
    3. Scroll down to the Apps section in the left menu
    4. Click Dynamic Screen Rules
    Navigation path to Dynamic Screen Rules configuration panel in Jira Project Settings

    Navigate to Project Settings → Apps → Dynamic Screen Rules

    What you'll see: The Dynamic Screen Rules configuration panel opens, showing an empty list (or existing rules if you've created some before).

  2. Start Creating a New Rule​

    Configure the basic settings to start creating your rule:

    1. Screen: Select the appropriate screen where the rule will apply

      • Global Issue Create - the create issue dialog
      • Issue View - the issue detail page
      • Issue Transition - status change dialogs

      For this tutorial, select Global Issue Create

    2. Target field: Select Root Cause (or whichever field you're using)

      • This is the field that will be shown/hidden based on conditions
      • Use the search box to find your field quickly

    3. Action category: Select the type of action you want to apply

      • For this tutorial, select Visibility (Show/Hide Field)
      • Other categories include: Required, Lock, Set Value, etc.

    4. Click the Add Rule button

    Initial rule configuration form showing Screen selection, Target Field, and Action category options

    Configure basic settings - Screen, Target Field, Action category, then click Add Rule

    What you'll see: A rule creation form appears with sections for scope, action details, and conditions.

    info

    What is a "Screen"? Screens are the three places in Jira where users interact with fields: Global Issue Create (create dialog), Issue View (issue detail page), and Issue Transition (status change dialogs). Learn more in Screens & Contexts.

  3. Set the Scope​

    Define which issue types this rule applies to.

    1. In the Scope section, find Work type (Issue Type)
    2. Select Bug from the dropdown or list
      • This means the rule will only apply to Bug issues
      • Other issue types (Story, Task, etc.) won't be affected
    Scope configuration section showing Issue Type selection with Bug selected

    Set the Scope - Select Bug from the Issue Type dropdown

    What you'll see: The scope shows "Work type: Bug" or "Issue Type: Bug."

    info

    Scope vs Conditions: Scope filters which issue types the rule applies to. Conditions define when the rule triggers within that scope. Here, we're scoping to Bugs, then adding a condition for Priority.

  4. Define the Action​

    Specify what happens when conditions are met.

    1. In the Actions section, set the specific action:

      • Select Show field to make the field visible when conditions are met
      • Or select Hide field to hide the field when conditions are met

      For this tutorial, select Hide field

    2. How it works:

      • When conditions are met, the field will be hidden
      • When conditions are NOT met, the field will remain visible
    Action configuration section showing Show field and Hide field options

    Define the Action - Select Hide field to hide the field when conditions are met

    What you'll see: The action section shows "Hide field when conditions are met" or similar text.

  5. Add a Condition​

    Now add the condition that determines when the field should hide.

    1. Click Add Condition
    2. Select Field value as the condition type
    3. Configure the condition:
      • Field: Priority
      • Operator: Equals
      • Value: High
    4. Click Add or Save to confirm the condition
    Condition configuration showing Field value type with Priority equals High

    Add a Condition - Configure Field = Priority, Operator = Equals, Value = High

    What you'll see: The condition appears showing "Priority equals High."

    tip

    How it works together: The rule now applies to Bug issues (scope) and triggers when Priority = High (condition). So the Root Cause field will be hidden for Bugs with High priority, but remain visible for lower-priority bugs.

  6. Save the Rule​

    1. Review your rule configuration:
      • Screen: Global Issue Create
      • Target field: Root Cause
      • Scope: Bug issue type
      • Condition: Priority equals High
      • Action: Hide field
    2. Click Save or Create Rule at the bottom of the form
    Rules list showing the newly created rule with auto-generated name and enabled status

    Save the Rule - The saved rule appears in the rules list with an automatically generated name

    What you'll see: The rule creation form closes and your new rule appears in the rules list with an automatically generated descriptive name. The rule is enabled by default.

    info

    Rules are enabled by default. Your rule is now active and will affect users creating issues in this project. You can disable it anytime using the toggle switch next to the rule name.

  7. Test Your Rule​

    Now verify that your rule works as expected by creating a test issue.

    Test 1: Initial State (Field Should Be Visible)

    1. Go to your project
    2. Click Create (or press 'c') to open the create issue dialog
    3. Select Issue Type: Bug
    4. Notice the default Priority is set to Medium (or leave it unselected)
    Create Issue dialog showing Bug issue type with Priority set to Medium, and Root Cause field visible

    Test 1: Initial state - Root Cause field is visible when Priority is Medium

    Expected result: The Root Cause field is visible on the form. You can see it and fill it in because the condition (Priority = High) is NOT met.

    Test 2: Change Priority (Field Should Disappear)

    1. Keep the same create issue dialog open
    2. Change Priority to High
    Create Issue dialog showing Bug issue type with Priority changed to High, and Root Cause field now hidden

    Test 2: After changing priority - Root Cause field is hidden when Priority is High

    Expected result: The Root Cause field disappears from the form immediately. It's hidden because the condition is now met (Priority = High).

    tip

    It works! If the field disappears instantly when you change Priority to High, your rule is working correctly. The form responds in real-time - no page refresh needed. Try switching back to Medium or Low priority, and the field should reappear immediately.

What You've Learned​

tip

Congratulations! You've created your first Dynamic Screen Rules rule and learned the fundamental building blocks of rule configuration.

You've Accomplished​

✅ Configuration AccessNavigated to the Dynamic Screen Rules panel in Project Settings → Apps
✅ Rule CreationCreated a rule with screen selection and target field configuration
✅ ScopingLimited the rule to specific issue types (Bug issues only)
✅ ConditionsAdded field-based condition to trigger when Priority = High
✅ ActionsDefined hide field action that executes when conditions are met
✅ TestingVerified your rule works correctly with real-time testing

Common Variations​

Now that you understand the basics, try these variations:

Hide Field for Multiple Priorities​

Want to hide Root Cause for both High AND Critical priorities?

How to do it:

  • Add another field-based condition: Priority equals Critical
  • Both Priority conditions will have OR relationship (hide if Priority = High OR Priority = Critical)
  • The scope (Bug issue type) still applies - rule only works for Bugs

Result: Root Cause will be hidden when Priority is either High OR Critical, giving you more control over when detailed analysis is needed.

info

Multiple conditions of the same type automatically use OR logic - no complex configuration needed!

Troubleshooting​

"The field doesn't hide even when conditions are met"

Possible causes:

  • The field isn't added to the screen in Jira's screen configuration
  • You're testing in a different project (rules are per-project)
  • The rule is disabled (check the toggle switch)
  • The action is configured incorrectly (should be "Hide field")

Solution:

  1. Verify the field is on the screen: Project Settings → Screens
  2. Verify you're in the correct project
  3. Check that the rule is enabled in Dynamic Screen Rules config
  4. Verify the action is set to "Hide field" not "Show field"
"The field hides but doesn't show when I change values"

Possible causes:

  • Browser cache issue
  • Conditions are configured incorrectly

Solution:

  1. Refresh the page and try again
  2. Review the conditions in the rule configuration
  3. Check that you're testing the right combination (when conditions are NOT met, field should be visible)
"I can't find the Dynamic Screen Rules in Project Settings"

Possible causes:

  • The app isn't installed
  • You don't have Project Administrator permissions

Solution:

  1. Verify installation: Jira Settings → Apps → Manage apps
  2. Ask your Jira admin for Project Administrator access

Next Steps​

Now that you've created your first rule, choose your learning path: