Troubleshooting

All errors the app can produce and how to find a solution.

Error Codes and Description

You might get errors when your input is incorrect, the app is not able to call the REST API or your license is expired. An error will look like so:

To fix the error state of the Customfield Editor for Jira as soon as possible, every error has an error code at the bottom right corner. Please have a look at your appearing error code in the table below to get back on track. An error code for the Customfield Editor looks like HTTP_400 and for license errors you get an expression like EXPIRED.

HTTP_400
validation

Validation Errors. The data sent was not valid.

Cause

This usually appears when something with the sent data is wrong.

Solution

Check the following:

  • The error message usually exactly tells you what is wrong. For example "CustomField with id 102000 has no context with id 2323", that means that the used contextId 2323 is wrong.

HTTP_401
unauthorized

The app is not able to call the REST API.

Cause

This usually means you are not logged in or your session is expired.

Solution

Check your input of:

  • Reloading the page.

  • Logout and log back into Jira.

HTTP_403
forbidden

You don't have permissions to access this resource.

Cause

This error means that you do not have permissions to access somehting.

Solution

If you are sure you should be able to access a page or resource, ask your Jira administrator if you have the correct permissions to acces the page/resource.

HTTP_504
gatewaytimeout

The app is not able to call the REST API.

Cause

This error means Jira is not reachable from the App.

Solution

Check the following cases:

  • Is Jira running and reachable?

  • Is the baseUrl of Jira correctly configured?

EXPIRED
Invalid license

Your evaluation license of Customfield Editor expired. Please use the 'Buy' button to purchase a new license.

Cause

A license is invalid if the current date is greater than or equal to the license's expiration date.

Solution

Please use the 'Buy' button to purchase a new license.

TYPE_MISMATCH
Invalid license

Your evaluation license of Customfield Editor expired. Please use the 'Buy' button to purchase a new license.

Cause

A license is invalid if its type (commercial, developer, academic, etc.) is incompatible with the type of the application license.

Solution

Please use the 'Buy' button to purchase a new license.

USER_MISMATCH
Invalid license

Your Customfield Editor is only licensed for ... users. Your ... installation requires a license for ... users. Please get a Customfield Editor license for ... users and try again.

Cause

A license is invalid if its maximum number of users property is less than that of the application license.

Solution

Please use the 'Buy' button to purchase a new license.

VERSION_MISMATCH
Invalid license

Your license for maintenance of Customfield Editor is not valid for version X.Y.Z. Please use the 'Renew' button to renew your Customfield Editor license.

Cause

A license is invalid if the app's build date is greater than or equal to the license's maintenance expiration date.

Solution

Please use the 'Renew' button to renew your license.

If you are lost after all, issue a support request.