Skip to main content
Skip table of contents

UI Modifications FAQ

This documentation provides a general explanation of UI modification errors in Jira


When working with Jira Cloud's UI Modifications, it is common to encounter errors when trying to modify custom fields.

Described below are some of the common errors that can occur as a result of using that component

Error when creating issue after a template is assigned

Some users have encountered the following error when creating an issue after a template is assigned:

We encountered an error while applying UI modifications to this form

image-20240906-113426.png

Why does this happen?

🔍 The most common cause is trying to modify fields that aren’t available in the current Jira issue. But don’t worry, we’ve got you covered!

Ensure Correct Field Context for Jira Issues

Before applying a template, ensure the fields you're modifying are correctly attached to the context of the Jira issue you're working with. Modifications may only succeed when the selected fields are available and properly configured in the issue's context.

âś… Supported Fields for UI Modifications

The fields listed below are fully supported for use with the SITC app and Jira’s UI Modifications API. These fields can be modified using templates, and they ensure that your modifications will function as expected.

📝 Pro Tip: Always double-check that these fields are available in the Jira issue context you’re modifying. Modifications only work on supported fields in the current issue view

Fields Not Supported

While we continue to expand support, not all fields are currently available for UI modifications. Fields that are not supported will result in errors when applying a template. You can find detailed guidance on limitations and upcoming features directly from Atlassian’s UI Modifications API documentation.


🚀 Tips to Avoid Errors

- Check Field Context: Make sure the fields you’re modifying are part of the current Jira issue’s context. If they aren’t, you’ll see an error!

- Keep Updated: Our team is constantly adding new field support. Stay tuned for updates!

- Double-Check with Atlassian: Unsure if a field is supported? Head to Atlassian’s API Reference to confirm.


đź“š Need More Help?

For more detailed instructions on applying templates, or troubleshooting errors, reach out to our support team for assistance.


JavaScript errors detected

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

If this problem persists, please contact our support.