Skip to main content
Skip table of contents

Issues Field Configuration

If Jira fields are required but not mapped in Create Issue settings or lack default values, the add-on cannot generate issues.

⚠️ Common Warning

"Please edit the task fields configuration" means Smart Forms cannot create issues because your project has unmapped required fields.

🛠️ Solution Steps

1️⃣ Access Field Configuration

  1. Go to Jira SettingsIssues

  2. In right panel, select FieldsField Configurations

2️⃣ Find Your Project Configuration

  1. Locate the Field Configuration used by your target project

  2. Usually named "Default Field Configuration"

  3. Click Configure button

3️⃣ Update Required Fields

  1. Find fields marked as Required

  2. Change them to Optional (e.g., Components → Optional)

  3. Save changes

💡 Alternative Solutions

🔧 Default Values

  • Set default values in Jira Automation

  • Smart Forms fills unmapped required fields with "Forms" text

👤 Admin Access

  • If you don't see configuration buttons, contact your Jira Admin

  • Admin permissions required for field configuration changes

🎯 Best Practices

📝 Map Essential Fields: Always map Summary and other critical fields in Create Issue settings
🔄 Test First: Submit test forms to verify issue creation works
⚙️ Project Setup: Ensure project field requirements match your form structure

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.