Customising the Look and Feel

You can easily customise JIRA's look and feel to suit your needs:

Log in as a user with the JIRA Administrators global permission.
Select Administration > System > User Interface > Look and Feel
Keyboard shortcut: g + g + start typing look and feel
The Look and Feel configuration page will be displayed as follows:
Screenshot: Look and Feel Configuration
To edit the logo, colours or time format, click the 'Edit Configuration' button at the bottom of the page, which opens the page in edit mode. In edit mode:
- To access the remaining options on the page, click 'Customize Colours And Dates' to expand this section of options.
- To save your configuration changes, click the 'Update' button.
- To leave edit mode and return to the 'Look and Feel Configuration' page, click the 'Cancel' button.
- To reset JIRA back to its default look and feel, click the 'Reset Defaults' button.
  Be aware that this is an immediate action and does not require the 'Update' button to be clicked.

Here is a list of the different configuration options available, and what they do.

On this page:

Logo

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:

Click 'Upload' to upload a new image for the logo/favicon.
Click 'URL' to point to the location of an existing image.
- A URL beginning with 'http://' or 'https://' is treated by JIRA as an absolute URL/path.
- A URL beginning with a forward slash '/' is treated as a path relative to the <jira-application-dir> subdirectory of your JIRA Installation Directory.
Click 'Default' to revert to using JIRA's default logo/favicon.

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.

Colours

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:

The colours you specify for each of the following options can be anything that is valid for both a font tag, and a stylesheet's 'color:' attribute.
When specifying a colour, you can use the pop-up colour chooser, or specify your own (eg. '#FFFFFF', 'red').
To return to the original colour scheme, just clear any values that you have set.

Gadget Colours

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:

The colours you specify for each of the eight options can be anything that is valid for both a font tag, and a stylesheet's 'color:' attribute.
When specifying a colour, you can use the pop-up colour chooser, or specify your own (eg. '#FFFFFF', 'red').
To return to the original colour scheme, just clear any values that you have set.

Date/Time Formats

The Look and Feel page allows you to customise the way times and dates are presented to users throughout the JIRA user interface.

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.

Configuring date picker formats

JIRA system administrators can configure the format of date pickers used throughout the JIRA user interface via options on the Advanced Settings page.

Be aware that these options are different from the Date/Time Formats configuration options on the Look and Feel page, which only customise JIRA's presentation of times and dates to users.

The date or date/time formats for date pickers are defined by a pair of properties (one for Java and the other for JavaScript). The two properties in this Java/JavaScript pair must match in order for the date (or date/time) picker they define to function 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 `jira.date.picker.java.format` property	Value of the `jira.date.picker.javascript.format` property
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 %e, %Y`
10/01/2010	`MM/dd/yyyy`	`%m/%d/%Y`

Here are some examples of date/time configurations:

Preferred Date/Time	Value of the `jira.date.time.picker.java.format` property	Value of the `jira.date.time.picker.javascript.format` property
15/Oct/10 8:50 AM	`dd/MMM/yy h:mm a`	`%d/%b/%y %l:%M %p`
10/15/10 08:50 AM	`MM/dd/yy hh:mm a`	`%m/%d/%y %I:%M %p`

Child pages