Configuring advanced settings

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

Jira has a small number of commonly edited advanced configuration options, which are stored in the Jira database. These options can be accessed and edited from the Advanced Settings page. You must be a Jira System Administrator to do this.

Editing Jira's advanced settings

To access and edit options on the 'Advanced Settings' page:

  1. In the upper-right corner of the screen, select Administration  > System
  2. Click the Advanced Settings button on the 'General Configuration' page.
  3. Edit the value of a Key by clicking its value on the right of the page and modifying the existing value.
    The table below has extended information on some of the Key values.

    Key
    Key configuration
    jira.attachments.number.of.zip.entriesConfiguring the number of files shown in the content of ZIP-format files on issues
    jira.clone.prefixConfiguring the cloned issue summary field prefix

    jira.date.picker.java.format
    jira.date.picker.javascript.format
    jira.date.time.picker.java.format
    jira.date.time.picker.javascript.format

    Configuring date picker formats
    jira.issue.actions.orderChanging the default order for comments from ascending to descending
    jira.projectkey.patternChanging the Project Key Format
    jira.search.views.default.maxThe default maximum number of issues exported from search results. Users can override the default by changing the URL tempMax parameter. This value must always be lower than or equal to the jira.serach.views.max.limit value.
    jira.search.views.max.limitThe absolute limit on the number of issues that can be exported from search results.
    jira.table.cols.subtasksConfiguring sub-task fields displayed on parent issues
    jira.view.issue.links.sort.orderConfiguring the order of linked issues displayed on the 'view issue' page
    jira.text.field.character.limitThis property limits the number of characters that can be entered into DescriptionEnvironments, Comments and text custom fields. The maximum is 2147483647. A value of 0 means unlimited characters.
    jira.comment.collapsing.minimum.hiddenThe minimum number of comments needed before the comment collapsing is enabled.
    jira.newsletter.tip.delay.daysThe number of days before a prompt to sign up to the Jira applications insiders newsletter is shown. A value of -1 disables this functionality.
    jira.bulk.create.max.issues.per.importThis property allows you to set the maximum number of issues a user can import via CSV at one time. The maximum is 2147483647. Entering a value of 0 will disable the importer for users.
    jira.export.html.enabledSpecifies whether users can export the JQL search results to HTML.
    jira.quicksearch.max.concurrent.searches

    The maximum number of concurrent searches that your users can perform by using the quick search. The limit applies to a single Jira instance (if you have Data Center with 5 nodes, the limit increases fivefold.)

    Many concurrent searches will affect Jira's performance. You can use JMX monitoring to see how your users are searching, and determine the best limit.

    crowd.encryption.encryptor.default

    This property defines password encryption algorithms:

    • DISABLED - disable the encryption. It’s an insecure option. We don’t recommend using it.

    • BASE64 - obfuscates passwords by encoding them with Base64. It’s an insecure option but it can be helpful in some cases. This option doesn’t require encryption keys. Learn more about backing up data.

    • AES_CBC_PKCS5Padding - standard AES implementation in CBC mode. We recommend using this option.

    com.atlassian.jira.issue.fields.usage.init.requiredThis property is related to the custom field usage data that appears on the Custom fields page (the Last value update column). It lets you recalculate this data based on the information from the database, which is useful if the data is corrupt and you need to recalculate it from scratch. When you set the property to true, a one-time recalculation will be performed during the next run of the CustomFieldUsageRecalculationJob. You can check the details of this job by going to Scheduler details in the administration area. Once the recalculation is successful, the property is set back to false.
  4. Click the Update button (which will appear in the Operations column on the right) to save the new value in the Jira database.
    (info) Please Note: 
    • Any changes you make to these properties/keys become effective immediately.
    • Click the General Settings button to return to the General Configuration page.


Related information

There are a handful of other advanced configuration options (which are of little interest to most Jira system administrators) whose default values can be customized in the jira-config.properties file located in the Jira application home directory, which you may want to edit. For details, please see Advanced Jira configuration.


Last modified on Oct 19, 2021

Was this helpful?

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