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:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. On the panel on the left, under the title 'Global Settings', click 'Look and Feel'.
  4. The 'Look and Feel Configuration' page will be displayed as follows:
    Screenshot: Look and Feel configuration (click to view larger image)
  5. To edit the logo, colours or time format, click the 'Edit Configuration' link at the bottom of the page. To reset to the default look and feel of JIRA, simply click the 'Reset Default' button.

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.

Colours

The following options control the appearance of the entire JIRA user interface.

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.

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.

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

These time and date formats are used throughout JIRA. To specify them, use the format described at http://java.sun.com/j2se/1.4.2/docs/api/java/text/SimpleDateFormat.html.

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
jira.date.picker.javascript.format = %b/%e/%y

10/05/10

jira.date.picker.java.format = MM/dd/yy
jira.date.picker.javascript.format = %m/%d/%y

Jan 5, 2010

jira.date.picker.java.format = MMM dd, yyyy
jira.date.picker.javascript.format = %b %d, %Y

10/05/2010

jira.date.picker.java.format = MM/dd/yyyy
jira.date.picker.javascript.format = %m/%d/%Y



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.