Documentation for JIRA 4.4. 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.
On this page:
The logo appears in the top left corner of every JIRA page while the favicon appears typically to the left of your your browser's URL field and on browser tabs displaying a page on your JIRA site. You can easily replace the default JIRA logo and/or favicon with an image of your choice.
Option |
Explanation |
---|---|
Preview (Logo) |
A preview of your JIRA site's current logo is shown here. |
Favicon Preview (Favicon) |
A preview of your JIRA site's current favicon is shown here. |
In edit mode:
http://
' or 'https://
' is treated by JIRA as an absolute URL/path./
' is treated as a path relative to the <jira-application-dir>
subdirectory of your JIRA Installation Directory. Tip: If you use a JIRA WAR distribution, it is recommended that you add your logo images to the edit-webapp
subdirectory of your JIRA Installation Directory prior to building your WAR distribution file. For details on building JIRA WAR distributions, refer to the application server-specific documentation in the Installing JIRA WAR section.
Please Note: If the JIRA logo/favicon does not appear after changing it to a custom one, ensure that the URL specified uses the correct case as this may be case-sensitive. Try copying and pasting the URL into a browser and check that the image appears.
The following options control the appearance of the entire JIRA user interface.
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. |
Please note:
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 specifying dates and times, they should be based on the Java SimpleDateFormat.
When you are not in edit mode on the 'Look and Feel' page, the examples in the rightmost column of the 'Date/Time Formats' section show you how the various formats will appear in JIRA.
To set the format of date pickers in JIRA, see Configuring Advanced Settings.
The date or date/time formats are defined by two (Java and JavaScript) properties. These two properties must match for the date (or date/time) picker to work correctly.
For Java formats, specify date/time formats based on the Java SimpleDateFormat.
For JavaScript formats, specify date/time formats based on the Unix date format.
Here are some example US-based date configurations:
Preferred Date | Value of the | Value of the |
---|---|---|
Oct/1/10 | MMM/d/yy | %b/%e/%y |
10/01/10 | MM/dd/yy | %m/%d/%y |
Oct 1, 2010 | MMM d, yyyy | %b %d, %Y |
10/01/2010 | MM/dd/yyyy | %m/%d/%Y |
Here are some examples of date/time configurations:
Preferred Date/Time | Value of the | Value of the |
---|---|---|
15/Oct/10 8:50 AM | dd/MMM/yy h:mm a | %e/%b/%y %I:%M %p |
10/15/10 08:50 AM | MM/dd/yy hh:mm a | %b/%e/%y %I:%M %p |