Atlassian navigation

A horizontal navigation component for Atlassian apps.

Deprecated

This package is deprecated. Use our new navigation system.

6.4.5

Patch Changes

  • Updated dependencies

6.4.4

Patch Changes

  • Updated dependencies

6.4.3

Patch Changes

  • Updated dependencies

6.4.2

Patch Changes

  • Updated dependencies

6.4.1

Patch Changes

6.4.0

Minor Changes

Patch Changes

  • Updated dependencies

6.3.3

Patch Changes

  • Updated dependencies

6.3.2

Patch Changes

  • Updated dependencies

6.3.1

Patch Changes

  • Updated dependencies

6.3.0

Minor Changes

  • d82e6f76528ab, (opens new window) - Add direct subpath package exports as part of the linking-platform, search, media, and design-system barrel-removal (de-barrel) migration.

    These packages now expose their individual modules via explicit package.json exports subpaths so that consumers can import directly from the leaf module (e.g. @atlaskit/pkg/thing) instead of the package barrel/index. This adds new public entry points without changing or removing any existing exports, so it is a backwards-compatible additive change.

    No runtime behaviour changes; this is an API-surface (entry-point) addition to support tree-shaking and to unblock removal of the barrel index files.

Patch Changes

  • Updated dependencies

6.2.1

Patch Changes

  • Updated dependencies

6.2.0

Minor Changes

  • 234fda770bd2b, (opens new window) - [ux] Fixed unsafe styles that distorted the inline (top-layer) tooltip/popover by excluding top-layer elements from the offending selectors via :not(:where([popover], dialog)) (and :nth-last-child(... of ...) for positional selectors). The :where() wrapper keeps the guard at zero specificity, so matching is otherwise unchanged, and the guards are no-ops for the legacy portalled tooltip.

    @atlassian/gemini additionally ignores Emotion's ":nth-last-child" server-side-rendering console warning, which it already ignored for ":first-child" and ":nth-child" (emotion-js/emotion#1105).

Patch Changes

  • Updated dependencies

6.1.8

Patch Changes

  • Updated dependencies

6.1.7

Patch Changes

  • Updated dependencies

6.1.6

Patch Changes

  • Updated dependencies

6.1.5

Patch Changes

  • Updated dependencies

6.1.4

Patch Changes

  • Updated dependencies

6.1.3

Patch Changes

  • Updated dependencies

6.1.2

Patch Changes

  • Updated dependencies

6.1.1

Patch Changes

  • 820f00bd7db09, (opens new window) - Enable platform-dst-motion-uplift-button by default in constellation examples so button motion is previewed in component demos. Docs/examples-only; no change to shipped component behaviour.

6.1.0

Minor Changes

  • cd097a2111788, (opens new window) - Republish packages depending on @atlaskit/react-compiler-gating so their published dependency reference is updated to the renamed @atlaskit/react-compiler-gating scope.

    The earlier rename of @atlassian/react-compiler-gating to @atlaskit/react-compiler-gating only bumped the renamed package itself, so dependent packages were never republished and their published versions still referenced the old @atlassian/react-compiler-gating name, which is not available in the public npm registry. This minor bump republishes all affected packages with the corrected dependency.

Patch Changes

  • Updated dependencies

6.0.1

Patch Changes

6.0.0

Major Changes

  • f2dc9097319f0, (opens new window) - ### Dropped support for legacy Typescript 4 types. Typescript 5 is now the new minimum.

    Removes the typesVersions property and dist/types-ts4.5 directory from the dist.

    Types are now exclusively via the "types": "dist/types/index.d.ts" property.

    - "typesVersions": { - ">=4.5 <4.9": { - "*": [ - "dist/types-ts4.5/*", - "dist/types-ts4.5/index.d.ts" - ] - } - },

Patch Changes

  • Updated dependencies

5.7.4

Patch Changes

  • Updated dependencies

5.7.3

Patch Changes

5.7.2

Patch Changes

  • Updated dependencies

5.7.1

Patch Changes

  • 76faad1c8c7b5, (opens new window) - Removed react-intl-next alias and replaced all usages with react-intl directly.

    What changed: The react-intl-next devDependency alias (which resolved to react-intl@^5) has been renamed to react-intl. This is a development-only change with no impact on consumers.

5.7.0

Minor Changes

Patch Changes

  • Updated dependencies

5.6.18

Patch Changes

  • Updated dependencies

5.6.17

Patch Changes

5.6.16

Patch Changes

  • Updated dependencies

5.6.15

Patch Changes

  • Updated dependencies

5.6.14

Patch Changes

5.6.13

Patch Changes

5.6.12

Patch Changes

5.6.11

Patch Changes

5.6.10

Patch Changes

5.6.9

Patch Changes

  • Updated dependencies

5.6.8

Patch Changes

  • Updated dependencies

5.6.7

Patch Changes

  • Updated dependencies

5.6.6

Patch Changes

  • Updated dependencies

5.6.5

Patch Changes

  • Updated dependencies

5.6.4

Patch Changes

  • Updated dependencies

5.6.3

Patch Changes

  • Updated dependencies

5.6.2

Patch Changes

  • Updated dependencies

5.6.1

Patch Changes

  • Updated dependencies

5.6.0

Minor Changes

Patch Changes

  • Updated dependencies

5.5.4

Patch Changes

5.5.3

Patch Changes

  • Updated dependencies

5.5.2

Patch Changes

5.5.1

Patch Changes

5.5.0

Minor Changes

  • f089cdf7f6a28, (opens new window) - PrimaryButton now supports displaying a shortcut in the tooltip, through the new shortcut prop. It is passed through to the Tooltip's shortcut prop.

5.4.2

Patch Changes

  • Updated dependencies

5.4.1

Patch Changes

  • Updated dependencies

5.4.0

Minor Changes

5.3.23

Patch Changes

  • Updated dependencies

5.3.22

Patch Changes

  • Updated dependencies

5.3.21

Patch Changes

  • Updated dependencies

5.3.20

Patch Changes

5.3.19

Patch Changes

5.3.18

Patch Changes

5.3.17

Patch Changes

5.3.16

Patch Changes

5.3.15

Patch Changes

5.3.14

Patch Changes

5.3.13

Patch Changes

  • Updated dependencies

5.3.12

Patch Changes

  • Updated dependencies

5.3.11

Patch Changes

5.3.10

Patch Changes

  • 0c3ef91864885, (opens new window) - Fixes a bug where when no custom theming preferences are set, iconColor and textColor still had colors set, overriding default logo colors and causing bugs with some logos. This change was previously tested behind a feature flag.

5.3.9

Patch Changes

  • Updated dependencies

5.3.8

Patch Changes

5.3.7

Patch Changes

  • Updated dependencies

5.3.6

Patch Changes

  • #185731, (opens new window) 58822a702f803, (opens new window) - [ux] Updated Atlassian navigation buttons to use subtle background states that match the default background token. Hovered state now uses color.background.neutral.subtle.hovered instead of color.background.neutral.hovered. Pressed state now uses color.background.neutral.subtle.pressed instead of color.background.neutral.pressed.

5.3.5

Patch Changes

  • Updated dependencies

5.3.4

Patch Changes

5.3.3

Patch Changes

  • Updated dependencies

5.3.2

Patch Changes

  • Updated dependencies

5.3.1

Patch Changes

5.3.0

Minor Changes

Patch Changes

  • Updated dependencies

5.2.0

Minor Changes

Patch Changes

  • Updated dependencies

5.1.10

Patch Changes

5.1.9

Patch Changes

  • Updated dependencies

5.1.8

Patch Changes

  • Updated dependencies

5.1.7

Patch Changes

  • Updated dependencies

5.1.6

Patch Changes

5.1.5

Patch Changes

  • Updated dependencies

5.1.4

Patch Changes

5.1.3

Patch Changes

  • Updated dependencies

5.1.2

Patch Changes

  • Updated dependencies

5.1.1

Patch Changes

  • Updated dependencies

5.1.0

Minor Changes

5.0.3

Patch Changes

5.0.2

Patch Changes

  • Updated dependencies

5.0.1

Patch Changes

  • Updated dependencies

5.0.0

Major Changes

Patch Changes

  • Updated dependencies

4.11.3

Patch Changes

  • Updated dependencies

4.11.2

Patch Changes

  • Updated dependencies

4.11.1

Patch Changes

  • Updated dependencies

4.11.0

Minor Changes

Patch Changes

  • Updated dependencies

4.10.4

Patch Changes

4.10.3

Patch Changes

  • Updated dependencies

4.10.2

Patch Changes

4.10.1

Patch Changes

4.10.0

Minor Changes

4.9.5

Patch Changes

  • Updated dependencies

4.9.4

Patch Changes

  • Updated dependencies

4.9.3

Patch Changes

4.9.2

Patch Changes

4.9.1

Patch Changes

4.9.0

Minor Changes

Patch Changes

  • Updated dependencies

4.8.0

Minor Changes

4.7.6

Patch Changes

  • Updated dependencies

4.7.5

Patch Changes

4.7.4

Patch Changes

  • Updated dependencies

4.7.3

Patch Changes

4.7.2

Patch Changes

  • Updated dependencies

4.7.1

Patch Changes

  • Updated dependencies

4.7.0

Minor Changes

4.6.0

Minor Changes

Patch Changes

  • Updated dependencies

4.5.2

Patch Changes

  • Updated dependencies

4.5.1

Patch Changes

  • Updated dependencies

4.5.0

Minor Changes

  • #127511, (opens new window) db30e29344013, (opens new window) - Widening range of react and react-dom peer dependencies from ^16.8.0 || ^17.0.0 || ~18.2.0 to the wider range of ``^16.8.0 || ^17.0.0 || ^18.0.0` (where applicable).

    This change has been done to enable usage of react@18.3 as well as to have a consistent peer dependency range for react and react-dom for /platform packages.

Patch Changes

  • Updated dependencies

4.4.1

Patch Changes

  • Updated dependencies

4.4.0

Minor Changes

4.3.2

Patch Changes

4.3.1

Patch Changes

  • Updated dependencies

4.3.0

Minor Changes

4.2.2

Patch Changes

  • Updated dependencies

4.2.1

Patch Changes

  • Updated dependencies

4.2.0

Minor Changes

4.1.4

Patch Changes

  • Updated dependencies

4.1.3

Patch Changes

  • Updated dependencies

4.1.2

Patch Changes

4.1.1

Patch Changes

  • Updated dependencies

4.1.0

Minor Changes

Patch Changes

  • Updated dependencies

4.0.0

Major Changes

Patch Changes

  • Updated dependencies

3.6.2

Patch Changes

  • Updated dependencies

3.6.1

Patch Changes

3.6.0

Minor Changes

3.5.0

Minor Changes

Patch Changes

  • Updated dependencies

3.4.2

Patch Changes

3.4.1

Patch Changes

3.4.0

Minor Changes

3.3.6

Patch Changes

3.3.5

Patch Changes

3.3.4

Patch Changes

3.3.3

Patch Changes

3.3.2

Patch Changes

  • Updated dependencies

3.3.1

Patch Changes

3.3.0

Minor Changes

Patch Changes

  • Updated dependencies

3.2.4

Patch Changes

3.2.3

Patch Changes

  • Updated dependencies

3.2.2

Patch Changes

  • Updated dependencies

3.2.1

Patch Changes

3.2.0

Minor Changes

  • #70040, (opens new window) d18ec4d7ce20, (opens new window) - [ux] Tidy up of the platform.design-system-team.icon-button-spacing-fix_o1zc5 Platform Feature Flag which applies a small adjustment to icon spacing for buttons using iconBefore and iconAfter props. Small visual adjustment is to be expected — keep this in mind when reviewing any VR tests breaking. The spacing around the icons will be reduced.

Patch Changes

  • Updated dependencies

3.1.2

Patch Changes

  • Updated dependencies

3.1.1

Patch Changes

3.1.0

Minor Changes

3.0.3

Patch Changes

3.0.2

Patch Changes

3.0.1

Patch Changes

  • Updated dependencies

3.0.0

Major Changes

2.10.0

Minor Changes

2.9.2

Patch Changes

  • Updated dependencies

2.9.1

Patch Changes

  • Updated dependencies

2.9.0

Minor Changes

Patch Changes

  • Updated dependencies

2.8.0

Minor Changes

  • #40069, (opens new window) d84be9a0f39, (opens new window) - [ux] We are testing icon button intenal spacing fix. We had to make related changes in dropdown menu button behind a fetaure flag. There is no visual difference but external changes instead. If the spacing fix is successful it will be available in a later release.

2.7.0

Minor Changes

2.6.19

Patch Changes

2.6.18

Patch Changes

2.6.17

Patch Changes

2.6.16

Patch Changes

2.6.15

Patch Changes

2.6.14

Patch Changes

2.6.13

Patch Changes

  • Updated dependencies

2.6.12

Patch Changes

  • Updated dependencies

2.6.11

Patch Changes

2.6.10

Patch Changes

  • Updated dependencies

2.6.9

Patch Changes

  • Updated dependencies

2.6.8

Patch Changes

2.6.7

Patch Changes

2.6.6

Patch Changes

2.6.5

Patch Changes

  • Updated dependencies

2.6.4

Patch Changes

  • Updated dependencies

2.6.3

Patch Changes

  • Updated dependencies

2.6.2

Patch Changes

2.6.1

Patch Changes

2.6.0

Minor Changes

2.5.2

Patch Changes

2.5.1

Patch Changes

2.5.0

Minor Changes

Patch Changes

  • Updated dependencies

2.4.1

Patch Changes

2.4.0

Minor Changes

Patch Changes

  • Updated dependencies

2.3.5

Patch Changes

2.3.4

Patch Changes

  • #28090, (opens new window) cdc1dd169be, (opens new window) - [ux] When updating tokens for Search component of atlassian-navigation package we found that some styles don't apply. This is due to the fact that some dynamic styles for hover and focus states used to be passed via style attribute. style attribute doesn't allow usage of pseudo-classes hens styles were never applied. We fixed this and made tokens follow the spec. However, to prevent consumer's VR tests from breaking we decided to fallback on default styles so the UI on legacy theming unchanged.

2.3.3

Patch Changes

  • Updated dependencies

2.3.2

Patch Changes

  • Updated dependencies

2.3.1

Patch Changes

  • Updated dependencies

2.3.0

Minor Changes

Patch Changes

  • Updated dependencies

2.2.10

Patch Changes

2.2.9

Patch Changes

2.2.8

Patch Changes

2.2.7

Patch Changes

2.2.6

Patch Changes

2.2.5

Patch Changes

2.2.4

Patch Changes

2.2.3

Patch Changes

2.2.2

Patch Changes

2.2.1

Patch Changes

  • Updated dependencies

2.2.0

Minor Changes

Patch Changes

  • Updated dependencies

2.1.6

Patch Changes

2.1.5

Patch Changes

2.1.4

Patch Changes

  • Updated dependencies

2.1.3

Patch Changes

2.1.2

Patch Changes

2.1.1

Patch Changes

2.1.0

Minor Changes

2.0.4

Patch Changes

2.0.3

Patch Changes

  • Updated dependencies

2.0.2

Patch Changes

2.0.1

Patch Changes

2.0.0

Major Changes

  • #14810, (opens new window) 47f58da5946, (opens new window) - ED-13322, ED-13324, ED-13326, ED-13323, ED-13204: Upgrade and support react-intl@^5.18.1 including breaking API changes, types and tests in atlassian-frontend packages

    What changed: Upgraded our react-intl support from ^2.6.0 to ^5.18.1. This means editor packages now rely on consumers installing ^5.18.1, otherwise editor usage of react-intl will mismatch with actual installed react-intl APIs. Why change was made: As part of a coordinated upgrade effort across AF packages, as react-intl v2 is quite dated. How consumer should update their code: Ensure react-intl ^5.18.1 is installed in consuming applications.

    Upgrade guide: To consume atlassian-frontend packages that use react-intl5 setup a second provider for the new version, using an npm alias

    "react-intl": "^2.6.0", "react-intl-next": "npm:react-intl@^5.18.1", import { IntlProvider } from 'react-intl'; import { IntlProvider as IntlNextProvider } from 'react-intl-next'; return ( <IntlProvider key={locale} data-test-language={locale} locale={locale} defaultLocale={DEFAULT_LOCALE} messages={messages} > <IntlNextProvider key={locale} data-test-language={locale} locale={locale} defaultLocale={DEFAULT_LOCALE} messages={messages} > {children} </IntlNextProvider> </IntlProvider> );

1.3.0

Minor Changes

1.2.2

Patch Changes

  • #15998, (opens new window) a2f953f3814, (opens new window) - Previously the ensure-design-token-usage eslint rule contained all checks relating to token use. This has now been split up into two separate rules:

    ensure-design-token-usage now covers:

    • legacyElevation — warns about old usages of the elevation mixins or styles, which instead should use the card or overlay tokens.
    • hardCodedColor — warns about use of hard-coded colors such as color: colors.B100, which instead should be wrapped in a token() call. This covers the majority of cases in existing codebases when first adopting tokens.

    no-unsafe-design-token-usage (new) covers the remaining rules:

    • directTokenUsage — warns against using the CSS Custom Property name that is output in the browser by the token() call. Eg. directly using var(--ds-accent-subtleBlue) is bad.
    • staticToken — warns when tokens aren't used inline. Inlining the token usages helps with static analysis, which unlocks future improvements. Eg. pulling the token out into a const like css={ color: token(primaryButtonText) } is bad.
    • invalidToken — warns when using a token that doesn't exist (not one that's been renamed, see the next point).
    • tokenRenamed — warns when using a token that's been renamed in a subsequent release.
    • tokenFallbackEnforced — warns if a fallback for the token call is not provided. Eg. call with the fallback like this token('color.background.disabled', N10) instead of token('color.background.disabled').
    • tokenFallbackRestricted — the opposite of tokenFallbackEnforced. Eg. do not pass in a fallback like this token('color.background.disabled', N10) and instead only include the token token('color.background.disabled').

    Upgrading — some instances of \\eslint-disable may need to be changed to the new rule. If you have failing lint rules after only bumping this package then switch those ignores to use no-unsafe-design-token-usage instead.

  • 22fb31312eb, (opens new window) - Fixes unmounted component state update warnings for AtlassianNavigation

  • f460cc7c411, (opens new window) - Builds for this package now pass through a tokens babel plugin, removing runtime invocations of the tokens() function and improving bundle size.

  • Updated dependencies

1.2.1

Patch Changes

1.2.0

Minor Changes

  • #14777, (opens new window) c9986657899, (opens new window) - Instrumented atlassian-navigation with the new theming package, @atlaskit/tokens.

    New tokens will be visible only in applications configured to use the new Tokens API (currently in alpha). These changes are intended to be interoperable with the legacy theme implementation. Legacy dark mode users should expect no visual or breaking changes.

Patch Changes

  • f791fab1bfa, (opens new window) - Added missing components and onBlur props to the props type used by secondary actions. These were already available but were not documented.
  • Updated dependencies

1.1.3

Patch Changes

1.1.2

Patch Changes

1.1.1

Patch Changes

1.1.0

Minor Changes

Patch Changes

1.0.0

Major Changes

0.12.6

Patch Changes

  • Updated dependencies

0.12.5

Patch Changes

0.12.4

Patch Changes

0.12.3

Patch Changes

0.12.2

Patch Changes

0.12.1

Patch Changes

0.12.0

Minor Changes

Patch Changes

  • Updated dependencies

0.11.5

Patch Changes

  • Updated dependencies

0.11.4

Patch Changes

0.11.3

Patch Changes

0.11.2

Patch Changes

0.11.1

Patch Changes

0.11.0

Minor Changes

Patch Changes

  • Updated dependencies

0.10.15

Patch Changes

0.10.14

Patch Changes

  • Updated dependencies

0.10.13

Patch Changes

0.10.12

Patch Changes

0.10.11

Patch Changes

0.10.10

Patch Changes

0.10.9

Patch Changes

0.10.8

Patch Changes

0.10.7

Patch Changes

0.10.6

Patch Changes

0.10.5

Patch Changes

  • Updated dependencies

0.10.4

Patch Changes

0.10.3

Patch Changes

0.10.2

Patch Changes

  • [patch]37edda3e89, (opens new window):
    • Fixes isHighlighted styles for SkeletonPrimaryButton without a dropdown
    • Updates hover, active and focus styles for all the skeletons
    • Supports children prop for SkeletonPrimaryButton so it has the same API as PrimaryButton
    • Adds documentation for the new skeleton components

0.10.1

Patch Changes

  • [patch]42eb460a09, (opens new window):

    Adds lightweight non-interactive skeleton buttons which can be used in SSR mode.

    Updates isHighlighted styles to be according to the design spec

0.10.0

Minor Changes

  • [minor]6e2dda87f4, (opens new window):

    Breaking Change:

    • Search component::
      • Added a required label prop
      • Renamed text prop to placeholder for clarity
    • AtlassianNavigation:
      • Added a required label prop

    Accessibility Changes

    • Search now has a search landmark, further described by a label prop on the text field
    • AtlassianNavigation now has a navigation landmark for use with screen readers; this landmark is further described by the label prop to differentiate it from side-navigation
    • AtlassianNavigation is wrapped in a header component
    • BadgeContainer is now hidden from screen readers, as the notification button's label contains the number of unread notifications

Patch Changes

0.9.6

Patch Changes

0.9.5

Patch Changes

  • [patch]6548261c9a, (opens new window):

    Remove namespace imports from React, ReactDom, and PropTypes- Updated dependencies 6548261c9a, (opens new window):

    • @atlaskit/docs@8.3.2
    • @atlaskit/visual-regression@0.1.9
    • @atlaskit/analytics-next@6.3.5
    • @atlaskit/badge@13.1.5
    • @atlaskit/button@13.3.7
    • @atlaskit/drawer@5.3.2
    • @atlaskit/icon@20.0.1
    • @atlaskit/logo@12.3.2
    • @atlaskit/menu@0.2.6
    • @atlaskit/popup@0.3.2
    • @atlaskit/spinner@12.1.4
    • @atlaskit/theme@9.5.1
    • @atlaskit/tooltip@15.2.3
    • @atlaskit/width-detector@2.0.10
    • @atlaskit/analytics-namespaced-context@4.1.11
    • @atlaskit/notification-indicator@7.0.11
    • @atlaskit/notification-log-client@4.0.10
    • @atlaskit/atlassian-notifications@0.1.4
    • @atlaskit/atlassian-switcher-test-utils@0.3.1
    • @atlaskit/atlassian-switcher@5.9.1

0.9.4

Patch Changes

0.9.3

Patch Changes

0.9.2

Patch Changes

0.9.1

Patch Changes

0.9.0

Minor Changes

0.8.5

Patch Changes

0.8.4

Patch Changes

0.8.3

Patch Changes

0.8.2

Patch Changes

0.8.1

Patch Changes

0.8.0

Minor Changes

Patch Changes

0.7.1

Patch Changes

0.7.0

Minor Changes

0.6.7

Patch Changes

0.6.6

Patch Changes

0.6.5

Patch Changes

0.6.4

Patch Changes

0.6.3

Patch Changes

0.6.2

Patch Changes

  • [patch]02d05ff668, (opens new window):
    • Fix types for the tooltip prop to allow React components.
    • Introduce buttonTooltip and iconButtonTooltip to configure tooltip for create button.

0.6.1

Patch Changes

0.6.0

Minor Changes

  • [minor]355e7ca2ea, (opens new window):

    Breaking changes from previous version:

    • Rename siteName to siteTitle to match what it is called in the products
    • Rename isSelected prop to isHighlighted to avoid confusion with the CSS states of the button, which is also exposed as a prop to Button

    Other visual changes:

    • Primary buttons in the nav with dropdowns stay highlighted when the drop down is open.
    • Fix active state in FF
    • Gradients for Atlassian products works correctly

0.5.1

Patch Changes

0.5.0

Minor Changes

  • [minor]48640192dc, (opens new window):

    Adds support for white nav. Repositions how the components are displayed. Changes to the theming API to support white nav. Add support for showing site name

0.4.9

0.4.8

Patch Changes

0.4.7

Patch Changes

0.4.6

Patch Changes

0.4.5

Patch Changes

0.4.4

Patch Changes

0.4.3

Patch Changes

0.4.2

Patch Changes

0.4.1

Patch Changes

0.4.0

Minor Changes

0.3.2

Patch Changes

0.3.1

Patch Changes

0.3.0

Minor Changes

0.2.2

Patch Changes

0.2.1

0.2.0

Minor Changes

0.1.3

0.1.2

Patch Changes

0.1.1

Patch Changes

Was this page helpful?
We use this feedback to improve our documentation.
© 2026 AtlassianTrademark, (opens new window)Privacy, (opens new window)License