AUI - Atlassian UI

A set of components for building user interfaces in Atlassian products and services.


Thorough documentation is available at the AUI website.



  • Chrome latest stable
  • Firefox latest stable
  • Safari latest stable (on OS X only)
  • IE 11+

How do you get it?

Consuming the AUI library is supported through a few methods:

Install as a Node package

AUI is released to Install it through your favourite package manager:

npm install @atlassian/aui yarn add @atlassian/aui

In the Node package, you will find:

  • dist/ contains pre-compiled javascript and css. This is the simplest way to use AUI.

  • lib/ contains individual AUI components. Use a CommonJS or AMD loader to load each component as your application needs.

  • src/ contains the raw JavaScript and LESS sources. It's unlikely you'll require these directly.

Install as an Atlassian-Plugin

All Atlassian Server products come with AUI pre-installed, so you don't need to do much to re-use it in your plugin.

Each AUI component has a web-resource key you can include it by. Consult each component's documentation on the AUI website for the key.

Download the distribution

AUI distributions are released to the aui-dist repo on Bitbucket. Note that this is equivalent to the dist/ folder available in the Node package.

Raising issues

Raise bugs or feature requests in the AUI project.


AUI is an Atlassian Developer Asset and is released under the Atlassian Developer Terms license. Some assets are released under the Atlassian Design Guidelines (ADG) license. See the licenses directory for information about AUI, ADG, and included libraries.