Link

A link takes people to a new location in the app or another website.
ExamplesUsageCodeMigration guideChangelog

5.1.3

Patch Changes

  • Updated dependencies

5.1.2

Patch Changes

5.1.1

Patch Changes

5.1.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

5.0.0

Major Changes

  • aaf7092923dc5, (opens new window) - Apply Volt entry-point and multi-export standards via volt-migrate-package. This is a major change to @atlaskit/link: the package exports map has been restructured so every public subpath now resolves directly to its ./src/* implementation instead of going through an intermediate ./src/entry-points/* re-export. No public subpaths were removed.

    Why this is breaking

    Because each subpath now points straight at its implementation module, a subpath and the package root can resolve to the same module instance. Consumers that deep-import the internal entry-points/* files, or that jest.mock() a specific subpath, may observe changed resolution/behaviour and need updating.

    Migration — public imports are unchanged

    Importing the published subpaths (or the package root) continues to work as before:

    // Still valid — no change required import Link from '@atlaskit/link/link';

    If you were reaching into the internal entry-point modules, switch to the public subpath:

    -import Link from '@atlaskit/link/entry-points/link'; +import Link from '@atlaskit/link/link';

    Before / after exports map

    "exports": { ".": "./src/index.tsx", - "./link": "./src/entry-points/link.tsx", + "./link": "./src/components/link/index.tsx", }

Patch Changes

  • Updated dependencies

4.3.5

Patch Changes

  • 44cfa83f61092, (opens new window) - Correct the list item motion transition timing. A CSS transition is governed by the timing declared on the state being transitioned into, so the pressed timing (motion.listitem.pressed, 100ms) belongs on :active, not :hover. Declaring it on :hover made normal → hover (and selected → hover) animate at 100ms instead of the intended 50ms. The :hover state now uses motion.listitem.hovered (50ms) across all list item consumers so both hovering and unhovering animate at 50ms, while :active keeps motion.listitem.pressed (100ms) and selected variants rest at motion.listitem.selected (100ms). Behaviour remains behind the platform-dst-motion-uplift-list-item feature gate.

4.3.4

Patch Changes

  • 6490d22c0d837, (opens new window) - Fix list item pressed motion so the hover to pressed transition uses motion.listitem.pressed (100ms) instead of the hover timing (50ms). The pressed timing is now declared on the :hover state so the transition into the pressed state animates correctly. Behaviour remains behind the platform-dst-motion-uplift-list-item feature gate.

4.3.3

Patch Changes

  • Updated dependencies

4.3.2

Patch Changes

  • Updated dependencies

4.3.1

Patch Changes

  • Updated dependencies

4.3.0

Minor Changes

Patch Changes

  • Updated dependencies

4.2.0

Minor Changes

  • 717d224e37e6a, (opens new window) - Add motion to Link hover and pressed states behind the platform-dst-motion-uplift-list-item feature gate: the link underline animates from coloured to transparent on hover/press, consuming the motion.listitem.* tokens (with the text-decoration-color transition driven by the matching motion.duration/motion.easing tokens). Rendering is unchanged when the gate is off.

4.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

4.0.1

Patch Changes

4.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

3.4.2

Patch Changes

  • Updated dependencies

3.4.1

Patch Changes

  • Updated dependencies

3.4.0

Minor Changes

3.3.4

Patch Changes

3.3.3

Patch Changes

3.3.2

Patch Changes

  • Updated dependencies

3.3.1

Patch Changes

  • Updated dependencies

3.3.0

Minor Changes

3.2.17

Patch Changes

  • Updated dependencies

3.2.16

Patch Changes

  • Updated dependencies

3.2.15

Patch Changes

3.2.14

Patch Changes

  • Updated dependencies

3.2.13

Patch Changes

  • Updated dependencies

3.2.12

Patch Changes

  • Updated dependencies

3.2.11

Patch Changes

  • Updated dependencies

3.2.10

Patch Changes

  • Updated dependencies

3.2.9

Patch Changes

  • Updated dependencies

3.2.8

Patch Changes

3.2.7

Patch Changes

  • Updated dependencies

3.2.6

Patch Changes

  • Updated dependencies

3.2.5

Patch Changes

3.2.4

Patch Changes

  • Updated dependencies

3.2.3

Patch Changes

  • Updated dependencies

3.2.2

Patch Changes

  • Updated dependencies

3.2.1

Patch Changes

  • Updated dependencies

3.2.0

Minor Changes

Patch Changes

  • Updated dependencies

3.1.0

Minor Changes

3.0.2

Patch Changes

3.0.1

Patch Changes

3.0.0

Major Changes

Patch Changes

  • Updated dependencies

2.2.0

Minor Changes

Patch Changes

  • Updated dependencies

2.1.2

Patch Changes

2.1.1

Patch Changes

  • Updated dependencies

2.1.0

Minor Changes

Patch Changes

  • Updated dependencies

2.0.2

Patch Changes

2.0.1

Patch Changes

  • Updated dependencies

2.0.0

Major Changes

  • #181101, (opens new window) b7ebb0f06c1a5, (opens new window) - Migrated from @emotion/react to @compiled/react in order to improve performance, align with the rest of the Atlaskit techstack, and support React 18 Streaming SSR. Please note, in order to use this version of @atlaskit/link, you will need to ensure that your bundler is configured to handle .css imports correctly. Most bundlers come with built-in support for .css imports, so you may not need to do anything. If you are using a different bundler, please refer to the documentation for that bundler to understand how to handle .css imports. For more information on the migration, please refer to RFC-73 Migrating our components to Compiled CSS-in-JS, (opens new window).

1.2.7

Patch Changes

1.2.6

Patch Changes

  • Updated dependencies

1.2.5

Patch Changes

1.2.4

Patch Changes

1.2.3

Patch Changes

1.2.2

Patch Changes

1.2.1

Patch Changes

1.2.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.

1.1.1

Patch Changes

  • Updated dependencies

1.1.0

Minor Changes

1.0.3

Patch Changes

1.0.2

Patch Changes

  • Updated dependencies

1.0.1

Patch Changes

1.0.0

Major Changes

Patch Changes

  • Updated dependencies

0.5.3

Patch Changes

  • Updated dependencies

0.5.2

Patch Changes

0.5.1

Patch Changes

  • Updated dependencies

0.5.0

Minor Changes

Patch Changes

  • Updated dependencies

0.4.1

Patch Changes

0.4.0

Minor Changes

0.3.2

Patch Changes

  • Updated dependencies

0.3.1

Patch Changes

0.3.0

Minor Changes

0.2.1

Patch Changes

  • Updated dependencies

0.2.0

Minor Changes

0.1.0

Minor Changes

Patch Changes

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