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.

Logo

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%'

Colours

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.

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:

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.

Note: for information about the Date Picker Format and Date Time Picker Format, please see 'Advanced JIRA configuration with jira-application.properties'.