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
Go to Jira Settings → Issues
In right panel, select Fields → Field Configurations
2️⃣ Find Your Project Configuration
Locate the Field Configuration used by your target project
Usually named "Default Field Configuration"
Click Configure button
3️⃣ Update Required Fields
Find fields marked as Required
Change them to Optional (e.g., Components → Optional)
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