Documentation for JIRA 4.3. Documentation for other versions of JIRA is available too.
You can easily customise JIRA's look and feel to suit your needs:
Here is a list of the different configuration options available, and what they do.
The logo appears in the top left corner of every JIRA page. You can easily replace the default JIRA logo with an image of your choice.
Option |
Explanation |
---|---|
URL |
This URL points to the absolute or relative path of the image that you wish to display at the top of the page. If the URL begins with 'http://' or 'https://' then the URL is treated as an absolute URL. Otherwise it will be treated as a relative URL, and the image will have to be packaged in the war file when you build JIRA. |
Preview |
When an image is selected, a preview will be shown here. |
Logo Width |
The width of the image, usually in pixels. You can use any format that is valid in an image tag. e.g. '100px', '80%' |
Logo Height |
The height of the image, usually in pixels. You can use any format that is valid in an image tag. e.g. '25px', '30%' |
If the JIRA Logo isn't appearing after changing it to a custom one, ensure that the URL specified has the correct case. The value is case-sensitive. Try copying and pasting the URL into a browser and check that it appears.
The following options control the appearance of the entire JIRA user interface.
Please note:
Option |
Explanation |
---|---|
Header Background Colour |
The background colour of the top bar (the one that includes the image). |
Header Highlight Background Colour |
The background colour of the text that sits inside the top bar, when selected or when the mouse hovers over it. |
Header Text Colour |
The colour of the text that sits inside the top bar (such as your user name when you are logged in). |
Header Text Highlight Colour |
The colour of the text that sits inside the top bar, when selected or when the mouse hovers over it. |
Header Separator Colour |
The colour of the horizontal line between the top bar and the navigation bar. |
Navigation Bar Background Colour |
The background colour of the bar that contains the links to 'Dashboards', 'Projects', etc. |
Navigation Bar Text Colour |
The text color of the links in the menu bar (e.g. 'Dashboards'). |
Navigation Bar Separator Colour |
The colour of the vertical dotted line between each menu item and its drop-down symbol (triangle). |
Link Colour |
The colour of the text links on any JIRA page. |
Link Active Colour |
The colour of the text links on any JIRA page, when selected. |
Heading Colour |
The colour of the text headings on any JIRA page. |
These seven colours are the seven options from which users can select when changing the colour of a gadget's frame on their JIRA dashboard. Colour 1 is the default frame colour for newly-added gadgets.
Please note:
When you are not in edit mode, the examples in the rightmost column show you how the various formats will appear.
To set the date picker format, see 'Advanced JIRA configuration with jira-application.properties'. Here are some example configurations for U.S time:
Preferred Date |
Configuration in jira-application.properties |
---|---|
Oct/1/10 |
jira.date.picker.java.format = MMM/d/yy |
10/05/10 |
jira.date.picker.java.format = MM/dd/yy |
Jan 5, 2010 |
jira.date.picker.java.format = MMM dd, yyyy |
10/05/2010 |
jira.date.picker.java.format = MM/dd/yyyy |