# @atlassian/johnson

> A frontend module for Johnson framework

Latest version **5.0.12** (published 2026-06-16) · SEE LICENSE IN LICENSE.txt license · 0 weekly downloads

## Install

```sh
npm install @atlassian/johnson
pnpm add @atlassian/johnson
yarn add @atlassian/johnson
bun add @atlassian/johnson
```

## Health

**Score 55/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 5.0.12 |
| Published | 2026-06-16 |
| First published | 2018-06-12 |
| Weekly downloads | 0 |
| License | SEE LICENSE IN LICENSE.txt |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 15 |
| Unpacked size | 3.6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Atlassian Pty Ltd. |
| Maintainers | atlassianartifactteam |
| Keywords | atlassian, johnson, jira, confluence |

## Links

- npm: https://www.npmjs.com/package/@atlassian/johnson
- Repository: https://stash.atlassian.com/scm/dcst/johnson-frontend
- Homepage: https://ecosystem.atlassian.net/browse/ATST
- npm.io page: https://npm.io/package/@atlassian/johnson

## Dependencies (15)

- [redux](https://npm.io/package/redux.md) 4.2.1
- [core-js](https://npm.io/package/core-js.md) 3.47.0
- [classnames](https://npm.io/package/classnames.md) 2.5.1
- [prop-types](https://npm.io/package/prop-types.md) 15.8.1
- [react-redux](https://npm.io/package/react-redux.md) 7.2.9
- [redux-thunk](https://npm.io/package/redux-thunk.md) 2.2.0
- [@atlaskit/icon](https://npm.io/package/@atlaskit/icon.md) 29.2.0
- [@atlassian/aui](https://npm.io/package/@atlassian/aui.md) 9.12.13
- [@babel/runtime](https://npm.io/package/@babel/runtime.md) 7.28.4
- [@atlaskit/button](https://npm.io/package/@atlaskit/button.md) 23.8.0
- [@atlaskit/spinner](https://npm.io/package/@atlaskit/spinner.md) 19.0.7
- [html-react-parser](https://npm.io/package/html-react-parser.md) 5.2.10
- [@atlaskit/modal-dialog](https://npm.io/package/@atlaskit/modal-dialog.md) 14.9.1
- [@atlassian/brand-logos](https://npm.io/package/@atlassian/brand-logos.md) 1.3.0
- [@atlaskit/section-message](https://npm.io/package/@atlaskit/section-message.md) 8.11.0

## Recent versions

- 5.0.12 (latest) — 2026-06-16
- 3.1.0-beta.0 (beta) — 2019-08-15
- 5.0.11 — 2026-05-29
- 6.0.1 — 2026-05-23
- 5.0.10 — 2026-05-11
- 5.0.9 — 2025-12-18
- 5.0.8 — 2025-11-21
- 5.0.5 — 2025-09-08
- 5.0.4 — 2025-09-08
- 5.0.3 — 2025-09-08
- 5.0.2 — 2025-09-08
- 5.0.1 — 2025-09-08
- 5.0.0 — 2025-08-19
- 3.4.2 — 2024-09-25
- 3.4.1 — 2024-09-24
- … 29 more at https://npm.io/package/@atlassian/johnson/versions

## README

# Johnson frontend

This is a frontend module for Johnson framework

## Releasing

For full step-by-step release instructions, see the [HOWTO Release johnson-frontend](https://hello.atlassian.net/wiki/x/FVRj-/) page on Confluence — that is the source of truth for the release process.

## Getting Started

After installing you can use it by importing the module itself and css:

```
import {createRoot} from 'react-dom/client';

import Johnson, {JIRA as ProductName} from '@atlassian/johnson';
import '@atlassian/johnson/build/johnson.css';

...

const root = createRoot(document.getElementById('root'));
root.render(
  <Johnson endpoints={endpoints} i18n={i18n} initialData={initialData} productName={ProductName} />
);
```

## Properties

* __endpoints__ (required)

  An object containing urls where the module will send requests to.

  ```
  {
    data: 'url to get events data',
    eventKbClickedAnalytics: 'analytics event, event kb article clicked',
    generalKbClickedAnalytics: 'analytics event, general kb article clicked',
    home: 'product home url',
    dismissEvents: 'url to dismiss events',
    kbLinkStartStop: 'kb article about starting a product',
    kbLinkMigrateConfigManually: 'kb article about migrating custom configurations manually',
    findTheLogs: 'kb article about finding and providing logs for support',
    addAndRemoveSystemProps: 'kb article about adding and removing system properties',
    migrateConfig: 'url to migrate custom configurations after an upgrade',
  }
  ```

  [kbLinkStartStop example](https://confluence.atlassian.com/confkb/startup-check-starting-confluence-936509882.html?utm_campaign=csseng_fy18_q3_server_confluence_errorstate&utm_medium=in-product&utm_source=Install)

  [findTheLogs example](https://confluence.atlassian.com/confkb/startup-check-providing-logs-for-support-936509900.html?utm_source=Install&utm_medium=in-product&utm_campaign=csseng_fy18_q3_server_confluence_errorstate)

  [addAndRemoveSystemProps example](https://confluence.atlassian.com/confkb/startup-check-add-or-remove-confluence-system-properties-938861976.html?utm_source=Install&utm_medium=in-product&utm_campaign=csseng_fy18_q3_server_confluence_errorstate)


* __i18n__ (required)

  An object containing translations.

  ```
  {
    'johnson.check.events.event.kblink': 'Learn more',
      'johnson.legacy.columnheading.description': 'Description',
      'johnson.legacy.columnheading.exception': 'Exception',
      'johnson.legacy.columnheading.level': 'Level',
      'johnson.legacy.columnheading.time': 'Time',
      'johnson.page.detail.restricted.footer': 'We can\'t show you any more detail here as the <code>hide.system.error.details</code> system property has been set. If you\'d like to see more details here, remove the system property.',
      'johnson.page.headline.title.error': 'Jira had problems starting up',
      'johnson.page.headline.title.warning': 'Preparing to start Jira',
      'johnson.page.headline.neutral': 'Jira had failed to start, but we're back up and running again',
      'johnson.page.footer': 'If you\'re unable to fix the problems and need to contact support, we can respond faster if you provide {0}the logs{1} of your instance.',
      'johnson.page.progress': 'Finishing up checks',
      'johnson.page.subheadline.error': 'This page is for Jira administrators. If you're seeing this page, your Jira administrator is probably working to restore the service.',
      'johnson.page.subheadline.neutral': 'Take me to my {0}Jira home{1}.',
      'system.error.progress.completed': 'This process is {0}% complete.',
      'johnson.page.helium.show.files': 'Show {0} files',
      'johnson.page.helium.close.button': 'Close',
      'johnson.page.helium.button.title': 'Copy configuration',
      'johnson.page.helium.cant.copy.files': 'The following files contain custom changes, but we can’t copy them automatically. You’ll need to reapply these changes manually.',
      'johnson.page.helium.description': 'To copy these changes to your new installation, click <b>Copy configuration.</b>',
      'johnson.page.helium.ignore.description': 'If you ignore and continue, Jira will start using the default configuration.',
      'johnson.page.helium.note': 'Note: Make sure you only copy over the changes not the entire files.',
      'johnson.page.helium.title': 'Some of your configuration files contain custom changes',
      'johnson.page.helium.modal.title': 'List of modified files',
      'johnson.page.helium.modal.description': 'The following files contain custom changes:',
      'johnson.page.helium.read.only.description': 'The listed configuration files contain custom changes. To keep your current configuration, re-apply these custom changes to the new version of the files during upgrade.',
      'johnson.page.helium.read.only.title': 'Upgrade: Custom changes have not been carried over',
      'johnson.page.helium.read.only.files.copied': `One or more files were successfully copied to your new installation. To finalize these changes, {0}restart Jira{1} now.`,
      'johnson.page.helium.success.title': 'Files copied successfully',
      'johnson.page.helium.success.description': 'We successfully copied {0} files to your new installation. If there are no other warnings on this page, you can {1}start Jira{2} now.',
      'johnson.check.acknowledge.warnings.cta': 'Ignore all warnings and continue',
      'johnson.warnings.ignore.cli': 'If you want to ignore these warnings and start Jira, you need to use the {0}-Djira.startup.warnings.disable{1} startup flag that will ignore the warnings. {2}Learn more{3}',
  }
  ```


* __productName__ (required)

  Defines what logo to be shown in the left top corner.
  Currently supported values: 'confluence', 'jira'.


* __initialData__

  Initial events data, if not provided request to endpoints.data will be sent to get it.

  ```
  {
    canAuthoriseUsers: bool, indicating that a product loaded far enough to be able to authorise users,
    checksComplete: bool, if true loading gif will appear at the bottom of the page,
    events: array of events, can be new or old, see below,
    errorsPresentButHidden: bool, should be true when hide.system.error.details flag is set
  }
  ```

  New style event:
  ```
  {
    description: 'required, event description',
    helpLink: 'not required, a link to be attached to description, works only with new events',
    title: 'required, event title',
    level: 'required, event level, can be fatal, error or warning. ',
    dismissible: 'not required, bool, indicates whether or not event is dismissible',
    templateContext: {  // not required, contains event rendering details
      type: 'template name, apart from default can be configCustomisation or configCustomisationSuccess,
      filesThatCanBeCopied: 'array of config files that can be migrated automatically to a new version, used in configCustomisation template',
      filesThatCannotBeCopied: 'array of config files that can not be migrated automatically to a new version, used in configCustomisation template',
      numberOfFilesCopied: 'number of config files migrated to a new version, used in configCustomisationSuccess template',
    }
  }
  ```

  Old style event:
  ```
  {
    old: 'should be set for old events',
    description,
    date,
    level,
    dismissible,
    exception,
    additionalMarkup: 'additional html markup to be attached to description. Can contain translation aliases, in that case make sure its included in i18n prop',
    progress
  }
  ```

---
_Source: https://npm.io/package/@atlassian/johnson · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
