Configuring the look and feel of your JIRA applications

This page tells you how to customize your JIRA installation to match your company's environment. One of the easiest things you can do to get started is to update your JIRA color scheme to match your company's logo (shown below).

  • Upload from File – click Browse to search for and upload a new image for the logo.
  • Upload fromURL –use one of the following conventions:

  • 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 application installation directory.
 

(warning) Note: For all of the following procedures, you must be logged in as a user with the JIRA Administrators global permission

If the JIRA logo 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.

If you don't like the change, simply click Undo.

Look and feel configuration

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

  1. Choose > System
  2. Select User Interface > Look and Feel
  3. The Look and Feel configuration page will be displayed as follows:
    Screenshot: Look and Feel Configuration 

    Logo, Site Title and Favicon


    Colors and Gadget Colors


    Day/Time Formats

  4. To edit the logo, see the next section on Logo and Favicon.
  5. To edit the colors, click on the individual colors and edit them directly. For more information, see the section below on Editing colors.

Logo and Favicon

The logo appears in the top left corner of every JIRA page while the favicon appears typically to the left of 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.

Element

Sizing information

Logo

The logo's height must be constrained to a maximum of 30px. It is also recommended to use a 57px width image.

Favicon

 The favicon must have PNG file format, it should be 32x32 pixels, 71x71 DPI and have 8 bit color depth for best results.

 Colors

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

Editing colors

To edit the colors, click on the individual colors and follow this procedure.

  1. Click on the color box for an element.
  2. This opens up the color display where you can create customized colors or enter specific color values:
  3. To save your changes, click Update.
  4. If you are unhappy with a color change, click the Revert button that displays in the row where you've made the change:

Usage Notes

  • The colors 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 color, you can use the pop-up color chooser, or specify your own (eg. '#FFFFFF', 'red').
  • To return to the original color scheme, just clear any values that you have set.

Gadget colors

These seven colors are the seven options from which users can select when changing the color of a gadget's frame on their JIRA dashboard. color 1 is the default frame color for newly-added gadgets.

(info) Please note:

  • The colors 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 color, you can use the pop-up color chooser, or specify your own (eg. '#FFFFFF', 'red').
  • To return to the original color scheme, just clear any values that you have set.

Date/Time Formats

The Look and Feel page allows you to customize 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.

Relative time is used in date/time formats

Issue date/time fields show a relative instead of absolute date/time format (for example: "Yesterday" instead of "20 May 2013 12:00 PM"). You can still see the absolute date/time by hovering over the field.

(info) The date/time format reverts to absolute after a week.If you want to switch off this format, set the jira.lf.date.relativize application property to 'false'. See Advanced JIRA application configuration and Disable relative dates in JIRA applications for more information.

Configuring date picker formats

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


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

(warning) 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.

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

Comments
2010-10-01 yyyy-MM-dd %Y-%m-%d ISO 8601 format

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

Comments
2010-10-15 08:50 yyyy-MM-dd HH:mm %Y-%m-%d %H:%M ISO 8601 format

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

 

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport