Users who are new to JIRA often find it confusing when it comes to filling in fields, especially custom fields. So it is useful for you as the administrator to provide useful tips and descriptions to explain what some of the fields are for.
In this recipe, we will be adding a help icon for the Team custom field.
Proceed with the following steps to add help tips to a custom field:
href
value to a real page containing help text.Need help to work out Team assignment? Try this:
<a class="help-lnk" href="/secure/ShowConstantsHelp.jspa?decorator=popup#Teams" title="Get help about Team" data-helplink="local" target="_blank"> <span class="aui-icon aui-icon-small aui-iconfont-help"></span> </a>
The following screenshot shows our new help icon:
JIRA allows us to use any valid HTML for custom field description, so we added a simple text and an anchor tag that links to an HTML page containing our help information. We also added a span tag with the proper style class to have the nice question mark icon used by Issue Type and Priority fields.
The data-helplink="local"
attribute for the anchor tag ensures when the user clicks on the help icon; the help page is opened in a separate page rather than redirecting the current page.
Normally, we put descriptions directly into the custom field's description textbox as demonstrated. You can also put your descriptions into the field configuration settings, such as hiding a field. Doing so offers the following advantages:
Proceed with the following steps to set field descriptions in field configuration: