Customizing the Look and Feel

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 from URL – 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 Installation Directory.

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

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. Log in as a user with the JIRA Administrators global permission.
  2. Choose > System. Select User Interface > Look and Feel.
    (tick) Keyboard shortcut: g + g + start typing 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


    Colours and Gadget Colours


    Day/Time Formats


    Refresh Client Resources

  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.

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.

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 Configuration for more information.

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.


(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-01yyyy-MM-dd%Y-%m-%dISO 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:50yyyy-MM-dd HH:mm%Y-%m-%d %H:%MISO 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

 

Last modified on Sep 12, 2013

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.