Add a custom message to the Create Issue screen in Jira server

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

The information in this page relates to customizations in Jira. Consequently, Atlassian Support cannot guarantee to provide any support for the steps described on this page as customizations are not covered under Atlassian Support Offerings. Please be aware that this material is provided for your information only and that you use it at your own risk.

Also, please be aware that customizations done by directly modifying files are not included in the upgrade process. These modifications will need to be reapplied manually on the upgraded instance.

This article walks through the steps on how to add a Message or Field on the JIRA Create Issue Screen

This KB does not apply for Edit or Transition screens due to the Comment field being added automatically into the screens. See JRASERVER-7323 - Comments provided when changing, linking or resolving an issue should be displayed next to the record of that action and JRASERVER-18505 - View & Edit Issue Improvements for more information.

Default Scenario

When you click on the "Create Issue" button, the system displays a pop-up window requesting data to submit a ticket.

Solution

Please, make sure you have the JIRA Toolkit Plugin installed and enabled in your instance.

In the example below, a user wants to add some important information that needs to be shown to users before they submit a ticket.

Within administrative access, proceed with the following:

  1. Go to the 'Custom Fields' page and click on the '+ Add Custom Field' button located in the top right corner of the screen:

    (Auto-migrated image: description temporarily unavailable)
  2. Select the option Message Custom Field (for edit) and click on the 'Next >>' button at the bottom of the page:

    (Auto-migrated image: description temporarily unavailable)
  3. Fill in the requested information and click the 'Finish' button at the bottom of the page:

    (Auto-migrated image: description temporarily unavailable)

    You can choose which 'Issue Types' and which 'Projects' you want this to be applied in.

    For this feature to work you have to enable HTML in custom field descriptions which is disabled by default:

    Jira Admin -> System -> Enable HTML in custom field descriptions and list item values

  4. Select the 'Default Screen' and hit the 'Update' button:

    (Auto-migrated image: description temporarily unavailable)
  5. You'll be redirected to the 'Custom Fields' page. Find your custom field and click on the 'cog' icon on the right corner of the screen and select 'Configure':

    (Auto-migrated image: description temporarily unavailable)
  6. Click on the 'Edit Default Value' link:

    (Auto-migrated image: description temporarily unavailable)
  7. Fill in the Message Field with the message of your choice:

    (Auto-migrated image: description temporarily unavailable)
    1 2 3 4 5 6 Please read this message carefully. Are you sure you want to submit a ticket? Have you read this page yet? This documentation can be very helpful and save time! Still, if you want to submit one, please click the second tab and enter the requested info. Thanks.
  8. Go to the 'Screens' page and click on the 'Configure' option for the Default Screen:

    (Auto-migrated image: description temporarily unavailable)
  9. Click on the 'Add Tab' option and fill in the name of the new tab (e.g. Message):

    (Auto-migrated image: description temporarily unavailable)
  10. Add the custom field created in Step 1 and drag-and-drop the new tab to the leftmost column:

    (Auto-migrated image: description temporarily unavailable)
  11. Go back to your dashboard and click on the 'Create Issue' button at the top center of the page.

    (Auto-migrated image: description temporarily unavailable)
  12. Voilá! From now on users will see the message when trying to create a new issue:

    (Auto-migrated image: description temporarily unavailable)

    If the field is added in new tab, this is how it will look like:

    (Auto-migrated image: description temporarily unavailable)
Updated on April 9, 2025

Still need help?

The Atlassian Community is here for you.