Documentation for JIRA 4.0. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

JIRA 4.0.2 has been released. Read the full JIRA 4.0.2 Release Notes and Upgrade Guide.
Don't have JIRA 4.0? Take a look at the features of JIRA's latest major version and try it out!

October 6, 2009

The Atlassian JIRA team is delighted to present a brand new version of one of the world's favourite issue-trackers.

We have improved the UI to provide contextual awareness, improving the navigation and usability with features like activity streams and issue history. We have also added the most powerful searching capabilities ever seen in a bug tracker, called JIRA Query Language (JQL). The simple auto-complete entry system makes it incredibly easy for any user to create sophisticated queries.

We have completely overhauled the JIRA dashboards to make it quick and easy for anyone to create and add gadgets, move them around using drag & drop, and share dashboards with other team members. Using the new Plugins 2.0 architecture, we built new dashboards using OpenSocial. This means each JIRA dashboard is an OpenSocial container allowing you to consume any OpenSocial compliant gadgets from either Atlassian tools or other external sources. Conversly, JIRA gadgets can be exposed in any OpenSocial container (like iGoogle, and soon, Confluence).

Upgrading to JIRA 4.0 is free for all customers with active JIRA software maintenance as of October 6, 2009.

Highlights of JIRA 4.0:

Thank you for your feedback:

More than 50 new feature requests implemented
More than 2600 votes fulfilled

Your votes and issues help us keep improving our products, and are much appreciated.


Upgrading to JIRA 4.0

JIRA 4.0 can be downloaded from the JIRA Download Center. Before upgrading, please refer to the JIRA 4.0 Upgrade Guide.

Also note that you will need to obtain a new license key before you can upgrade. Obtaining a new JIRA 4 license key is free and the key is valid for the remainder of your existing maintenance period. For details, please see the JIRA licensing changes FAQ.

Highlights of JIRA 4.0

Advanced Searching

The power of search can never be understated, especially in a system like JIRA that sits at the centre of your development team.

JIRA Query Language (or JQL) brings search to whole new level!

JQL is a structured query language that provides support for logical operations, including AND, OR, NOT, NULL, EMPTY — even on custom fields:

Using JQL is simple even for those who don't know what "DBA" means. Just start typing and the auto-complete feature starts to suggest fields, operators and values for you to define your query.

You can now create more advanced filters such that you can stay up to date using RSS feeds & e-mail subscriptions, as well as see detailed statistics and charts, on issues that you are actually interested in.

Dashboard Gadgets

Whether you are tracking bugs or managing your entire development process, JIRA dashboards let you stay up to date on what matters most.

The new-look JIRA dashboard not only looks awesome, it now uses industry-standard 'gadgets'. So you can add external gadgets to your JIRA dashboard, as well as displaying JIRA gadgets in other places (such as iGoogle).

You can easily customise your dashboard by choosing a different layout, adding more gadgets, dragging the gadgets into different positions and changing the look of individual gadgets.

What's happened to your favourite JIRA portlets? Don't worry, every portlet that previously shipped with JIRA has been converted to a gadget.

If you are a plugin developer and have created your own portlets, see the instructions for converting your portlets to gadgets.


Activity Streams

The new activity stream allows you to stay up to date with exactly what is going on right this moment, what happened in that last hour or last few days.

Activity streams appear where you need them most — your user profile, project summary and view issue screens. You can even add an activity stream as a gadget on your dashboard.

The activity stream also provides an RSS feed, allowing you to subscribe to very specific RSS feeds of only the information that is most relevant to you.

See the documentation for more details.


New-look "Browse Project"

Understanding the status of your projects just got a lot easier with the new browse project UI.

Quickly see what work is complete as well as outstanding. You can then drill down to specific issues you want to see.

Your Bamboo builds, FishEye source information and Crucible code reviews are only a click away, as well.

See the documentation for more about browsing projects, versions and components.

Charting Now Comes Standard

We've built charts into JIRA and given them a visual redesign as well.

Also, the "Resolution Time" field from the Charting plugin is now part of JIRA, so every issue now automatically has its resolution time recorded.


New-look Header

The new-look JIRA header gives you quick access to all of the most commonly-used functions. Creating an issue just got even faster!

Click to zoom in:

If you prefer keystrokes rather than mouse-clicks, you'll be pleased to know that you can use your keyboard to navigate the new header menus.

Issue Actions in the Issue Navigator

By popular request, issues are now actionable directly from the Issue Navigator:

The "Actions" menu is also available for the list of sub-tasks within an issue.

Project Icons

You can now give your project a visual identity, thanks to the introduction of project icons ('avatars'):


Default Unit for Time Tracking

You can now specify your preferred Default Unit (minutes/hours/days/weeks) for your JIRA system. This will be applied whenever users log work on an issue without specifying a unit.


"History" is now permanent

Your list of recently-viewed issues is now stored in JIRA's database — so it's available after you log out and back in, even if you use a different machine.


Engine Room

Beyond the 'Back' Button

When navigating away from a page where you have modified data, you will be prompted to see if you would like to save the data or discard your changes (see JRA-14911).

Index Queue

Index updates are now put in a queue. So even if the update takes longer than 30 seconds, the operation remains on the queue and is not lost. (See JRA-14220.)


Plus over 900 other fixes and improvements

The top 50 most popular issues resolved in JIRA 4.0 are listed below. Click here for the full list.

Key T Summary P Status
JRASERVER-6344 Bug Send to both previous and current assignees for all notifications Medium Resolved
JRASERVER-5201 Bug Enable filter to specify more than 1 user Medium Resolved
JRASERVER-10427 Bug Changing field descriptions in "Field Configurations" for custom fields does not work Medium Resolved
JRASERVER-14031 Bug Form data lost when using back and forward web browser buttons Medium Resolved
JRASERVER-9048 Bug Calendar week begins with sunday independently from locale Medium Resolved
JRASERVER-15546 Bug Versions no longer display descriptions when browsing project Medium Resolved
JRASERVER-13801 Bug Call method addWorklogAndAutoAdjustRemainingEstimate, the soap server reponse with this type IssueServiceImpl$RemoteWorklogImpl Low Resolved
JRASERVER-12525 Bug Emails containing attachments with non-ASCII names lost High Resolved
JRASERVER-13035 Bug CSV import can not import resolution date. Low Resolved
JRASERVER-13011 Bug Component of a subtask is still component of original project after moving an issue High Resolved
JRASERVER-13689 Bug Saved filters reverted to "All projects" when we deleted a project contained Medium Resolved
JRASERVER-11933 Bug AutoTransitionListener - Reopen transition deletes issue summary Medium Resolved
JRASERVER-12200 Bug Reporter system field throws ClassCastException after populateFromIssue() and validateFromParams() Medium Resolved
JRASERVER-17845 Bug Wiki Renderer color tag doesn't work around bullets, numbers, or tables. Low Resolved
JRASERVER-15309 Bug Wrong assignee drop-down list sorting with non-ascii characters Low Resolved
JRASERVER-19031 Bug Allow to configure the limit of 50 issues for my Watches or Votes portlet High Resolved
JRASERVER-16498 Bug Version/s and Component/s not validated when updating an issue High Resolved
JRASERVER-18927 Bug URLs have double // in chart gadgets for links to issue navigator Medium Resolved
JRASERVER-18127 Bug Dashboards with infeasibly large titles cause display issues unless you have a 24" monitor Medium Resolved
JRASERVER-17936 Bug JQL: Anonymous user can run issueHistory() function - documentation needs to be fixed Medium Closed
Showing 20 out of 696 issues Refresh