How to edit the file

Still need help?

The Atlassian Community is here for you.

Ask the community


This article covers how to specifically make changes to the file located in <jira-home> directory as is also outlined in Advanced JIRA application configuration.


Please note, in new JIRA applications installations, this file may not exist, so it will have to be created.

  • Custom values for remaining advanced configuration options (i.e. not stored in the JIRA application database) are stored as individual key-value pairs in a file called (located in the JIRA application home directory).
  • To make changes to the file:

    1. Shut down your JIRA applications (for example, by executing either the /bin/ or \bin\stop-jira.bat file in your JIRA applications Installation directory, or by stopping the JIRA application service).
    2. Open the file (located at the root of your JIRA application home directory) in a text editor.

      This file may not exist if you are using a new installation or an upgraded installation where your previous JIRA application versions had never been customized. If this file does not exist, create it using a text editor.

    3. Edit the appropriate properties in this file.

      tip/resting Created with Sketch.
      • To determine the default value of a property whose value you wish to redefine, search for that property in the jpm.xml file, which is located in the atlassian-jira/WEB-INF/classes subdirectory of your JIRA Installation Directory. The default value is defined in the <default-value/> sibling element of the relevant property's <key/> element.
      • To override a property's default value in jpm.xml (which is not already defined in your file or available on the 'Advanced Settings' page):
        1. Copy the value of the relevant property's <key/> element from the jpm.xml file to the file.
        2. In the file, add an '=' after that property's key, followed by your custom value.
      • To disable a custom property's value in the file, either 'comment out' the property with a preceding '#' symbol or remove the property from the file.
    4. Save your modifications to the file.
    5. Restart your JIRA applications.

    In new JIRA application installations, this file may not initially exist and if so, needs to be created manually.

Example contents to demonstrate format
jira.projectkey.warning = testwarning
jira.projectkey.description = testdescription
Description This article covers how to specifically make changes to the file located in <jira-home> directory as is also outlined in our documentation on Advanced JIRA application configuration.
Product Jira
Platform Server
Last modified on Nov 2, 2018

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.