NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
An icon is a symbol representing a command, device, directory, or common action.
Last release 12 days ago
29 Sep 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
10 years old
427 releases · first in 2017
`3fbc5931c675b` - This release updates icons in @atlaskit/icon.
3fbc5931c675b -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
panel-leftpanel-rightUpdated dependencies
`d5e83674049bd` - Restore the deprecated metadata entry point required by existing consumers, including the no-deprecated-imports ESLint rule tests.
d5e83674049bd -
Restore the deprecated metadata entry point required by existing consumers, including the
no-deprecated-imports ESLint rule tests.One column per quarter.
`0c7c7be927bde` - Remove deprecated Volt re-export shims from public package entry points. Consumers should import from the replacement subpaths or im…
0c7c7be927bde -
Remove deprecated Volt re-export shims from public package entry points. Consumers should import
from the replacement subpaths or implementation entry points instead.### Patch Changes - Updated dependencies
### Patch Changes - Updated dependencies
### Patch Changes - Updated dependencies
`93685755a235e` - This release updates icons in @atlaskit/icon.
93685755a235e -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-pie`bd2c5b0112185` - Remove stale API report artifacts from published Platform packages.
bd2c5b0112185 -
Remove stale API report artifacts from published Platform packages.`4612437357f61` - Remove references to the unused @atlassian/icon-private package. Its value is dropped from the icon metadata location union, the ens
4612437357f61 -
Remove references to the unused @atlassian/icon-private package. Its value is dropped from the
icon metadata location union, the ensure-icon-color lint rule no longer matches it, and the
adoption scanner no longer scans its entrypoint.`3bcd16de0216e` - Experimental React 19 peer dependency support. This patch widens the peer range; CI coverage is partial.
3bcd16de0216e -
Experimental React 19 peer dependency support. This patch widens the peer range; CI coverage is
partial.Use @atlassian/testing-library exclusively in unit tests.
@atlassian/testing-library exclusively in unit tests.`d82e6f76528ab` - Add direct subpath package exports as part of the linking-platform, search, media, and design-system barrel-removal (de-barrel) migr
d82e6f76528ab -
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.
`19f67a13fde54` - This release updates icons in @atlaskit/icon.
19f67a13fde54 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-pie`9f6f84dd3db72` - This release updates icons in @atlaskit/icon.
9f6f84dd3db72 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-piecross-circledata-flow### Patch Changes - Updated dependencies
`9356675edac18` - Replace generated ./src/* subpath export keys with lint-safe equivalents. The de-barreling migration produced export keys containing
9356675edac18 -
Replace generated ./src/* subpath export keys with lint-safe equivalents. The de-barreling
migration produced export keys containing a src segment (e.g. @atlaskit/select
"./src/select"), which are forbidden by no-restricted-imports (@atlaskit/*/src/*) in
downstream products.
Renamed keys:
@atlaskit/select: ./src/select → ./default@atlaskit/icon: ./src/constants → ./constants/default@atlaskit/react-select: ./src/async → ./async/default, ./src/creatable →
./creatable/default@atlaskit/heading: ./src/heading-context → ./heading-context/default@atlaskit/flag: removed the redundant ./src/flag-group key (duplicate of the existing
./flag-group export)The underlying source targets are unchanged.
### Patch Changes - Updated dependencies
`edeb4ec55e98c` - Remove ts-node dependency. Regenerate icon glypths.
edeb4ec55e98c -
Remove ts-node dependency. Regenerate icon glypths.@atlaskit/icon/deprecated-core — now resolves directly to src/deprecated-core.tsx
c50236f04a5d5 -
Flatten entry points for @atlaskit/icon and remove multiple-export violations.
New and updated subpath exports are now available directly:
@atlaskit/icon/components/icon-new — direct component path (new)@atlaskit/icon/deprecated-core — now resolves directly to src/deprecated-core.tsx@atlaskit/icon/deprecated-map — now resolves directly to src/deprecated-core.tsx@atlaskit/icon/icon-tile — now resolves directly to src/components/icon-tile/index.tsx@atlaskit/icon/metadata-core — now resolves directly to src/metadata-core.tsx@atlaskit/icon/skeleton — now resolves directly to src/components/skeleton.tsx@atlaskit/icon/types — now resolves directly to src/types.tsxNo migration required for existing imports — all existing subpath exports remain valid. The
./icon-new subpath continues to work as before via src/entry-points/icon-new.tsx.
`1502a8099fc80` - This release updates icons in @atlaskit/icon.
1502a8099fc80 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-pie### Patch Changes - Updated dependencies
`eb572c1c104f1` - Removed the shape prop, UNSAFE_circleReplacementComponent prop, and IconTileCircleProps type from IconTile. Circle-shaped icon tiles
eb572c1c104f1 -
Removed the shape prop, UNSAFE_circleReplacementComponent prop, and IconTileCircleProps type
from IconTile. Circle-shaped icon tiles are no longer supported — IconTile now renders a
square tile only.
Feature gates platform_dst_icon_tile_circle_replacement and
platform_dst_icon_tile_circle_replacement_stage2 have been cleaned up.
Migration: If you were using
<IconTile shape="circle" UNSAFE_circleReplacementComponent={<MyComponent />} />, replace the
entire <IconTile> with <MyComponent /> directly.
`220103ecf27a6` - This release updates icons in @atlaskit/icon and @atlaskit/icon-lab.
220103ecf27a6 -
This release updates icons in @atlaskit/icon and @atlaskit/icon-lab.
@atlaskit/icon/core
chart-pie@atlaskit/icon-lab/core
text-rephrasetext-review`cd097a2111788` - Republish packages depending on @atlaskit/react-compiler-gating so their published dependency reference is updated to the renamed @a
cd097a2111788 -
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.
`ee28cf33718b0` - Add @atlaskit/react-compiler-gating as a runtime dependency to enable React Compiler platform gating.
ee28cf33718b0 -
Add @atlaskit/react-compiler-gating as a runtime dependency to enable React Compiler platform
gating.`f2dc9097319f0` - ### Dropped support for _legacy_ Typescript 4 types. Typescript 5 is now the new minimum.
f2dc9097319f0 - ###
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"
- ]
- }
- },
`9c0155c00d835` - This release updates icons in @atlaskit/icon.
9c0155c00d835 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-pie`16804116e2d36` - This release updates icons in @atlaskit/icon.
16804116e2d36 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-pie`14dec73701a1e` - This release updates icons in @atlaskit/icon.
14dec73701a1e -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
addchart-piecross`28617d8f348d3` - This release updates icons in @atlaskit/icon.
28617d8f348d3 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
addchart-piecross`2b84ca637685f` - [ux] Cleans up the IconTile API following the rollout of platform_dst_new_icon_tile and platform_dst_new_icon_tile_stage2 flags.
2b84ca637685f -
[ux] Cleans up the IconTile API following the rollout of platform_dst_new_icon_tile and
platform_dst_new_icon_tile_stage2 flags.
size="16" removed — Migrate to direct icon glyph usage (e.g. <MyIcon label="..." />), or
use size="xsmall" for the smallest tile (20px).size values "24", "32", "40", "48" have been removed.
Migrate to t-shirt sizes:
"small" (replaces "24")"medium" (replaces "32")"large" (replaces "40")"xlarge" (replaces "48")LegacyIconTileSize and NewIconTileSize types removed — Use IconTileSize directly.medium (previously - small).UNSAFE_circleReplacementComponent is required if shape='circle' is passed in.`b75e40f942dce` - This release updates icons in @atlaskit/icon.
b75e40f942dce -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
ai-generative-text-summarybriefcasechart-piecustomizefilter`2839666e3fb27` - This release updates icons in @atlaskit/icon.
2839666e3fb27 -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-piepaint-bucket`0e2b29db61e0a` - This release adds icons in @atlaskit/icon.
0e2b29db61e0a -
This release adds icons in @atlaskit/icon.
@atlaskit/icon/core
bezier-curvefigma-communityfigma-component-instance-swapfigma-component-instancefigma-componentfigma-slotfigma`a8a1708dfe5e6` - This release adds and updates icons in @atlaskit/icon.
a8a1708dfe5e6 -
This release adds and updates icons in @atlaskit/icon.
@atlaskit/icon/core
quotation-block@atlaskit/icon/core
chart-piemarkdown`7d6e9b5e6e7c6` - Autofix: add explicit package exports (barrel removal)
7d6e9b5e6e7c6 -
Autofix: add explicit package exports (barrel removal)`a42fb7e88fcfa` - This release updates icons in @atlaskit/icon.
a42fb7e88fcfa -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
text### Patch Changes - Updated dependencies
`ddd049a745d38` - Internal change to how legacy colors are applied. No visual changes.
ddd049a745d38 -
Internal change to how legacy colors are applied. No visual changes.### Patch Changes - Updated dependencies
`02483200273ec` - Enrol all Design System UI packages into the React Compiler with platform gating via isReactCompilerActivePlatform.
02483200273ec -
Enrol all Design System UI packages into the React Compiler with platform gating via
isReactCompilerActivePlatform.`22bf79dbdcdca` - Internal changes to remove unnecessary token fallbacks and imports from @atlaskit/theme
22bf79dbdcdca -
Internal changes to remove unnecessary token fallbacks and imports from @atlaskit/theme`af4d3f68227b4` - Removed the default export (Icon), ./base, ./svg entry-points, and SVG named export.
af4d3f68227b4 -
Removed the default export (Icon), ./base, ./svg entry-points, and SVG named export.
- import Icon from `@atlaskit/icon`
- import Icon from `@atlaskit/icon/base`
- import SVG from `@atlaskit/icon/svg`
Creating custom icons using icon base component or SVG component are no longer supported. Please
migrate to native <svg /> or choose one of the icons from provided icon set (e.g.
import AddIcon from "@atlaskit/icon/core/add")
`08170da1fbf62` - Migrate spacing prop usages on icons to Flex wrapper
08170da1fbf62 -
Migrate spacing prop usages on icons to Flex wrapper08170da1fbf62 -
Update codemod and eslint to handle different scenarios to migrate spacing props`af37f7d87df51` - Deprecate spacing prop on icon components via JSDoc @deprecated annotation, and update ADS website docs (Icon > Examples, Icon > Usa…
af37f7d87df51 -
Deprecate spacing prop on icon components via JSDoc @deprecated annotation, and update ADS
website docs (Icon > Examples, Icon > Usage) to reflect the deprecation with migration guidance.`0daada0469ab8` - Remove @atlaskit/icon/migration-map entry point, IconMigrationMap and IconMigrationSizeGuidance types from @atlaskit/icon, and @atla
0daada0469ab8 -
Remove @atlaskit/icon/migration-map entry point, IconMigrationMap and
IconMigrationSizeGuidance types from @atlaskit/icon, and @atlaskit/icon-lab/migration-map
entry point. These were only needed to support the legacy glyph icon migration path which has now
been fully completed. Remove the no-legacy-icons ESLint rule from
@atlaskit/eslint-plugin-design-system as @atlaskit/icon/glyph and
@atlaskit/icon/core/migration no longer exist.`c426ad3d11c7c` - Fixes to icon build process
c426ad3d11c7c -
Fixes to icon build process`a61a3677df8a5` - Remove core/migration/* entries from deprecated icon docs. The core/migration/* icon components no longer exist following the remova…
a61a3677df8a5 -
Remove core/migration/* entries from deprecated icon docs. The core/migration/* icon
components no longer exist following the removal of @atlaskit/icon/glyph legacy icons.`f1ef2305b8862` - Remove legacy icon glyphs and oldName prop support from metadata core.
f1ef2305b8862 -
Remove legacy icon glyphs and oldName prop support from metadata core.`99726ea06a76c` - This release updates icons in @atlaskit/icon.
99726ea06a76c -
This release updates icons in @atlaskit/icon.
@atlaskit/icon/core
chart-pieperson-addperson-addedperson-offboardperson-removeperson-warningscreen-plus`5e06fddfce409` - Rename codemod to next-icon-spacing-to-flex-primitive (now discoverable via npx @atlaskit/codemod-cli) and update no-icon-spacing-pr
5e06fddfce409 -
Rename codemod to next-icon-spacing-to-flex-primitive (now discoverable via
npx @atlaskit/codemod-cli) and update no-icon-spacing-prop ESLint rule to generate Flex
wrapper instead of Box.`a788a4cabea12` - Add codemod to migrate icon spacing prop to Box primitive
a788a4cabea12 -
Add codemod to migrate icon spacing prop to Box primitive`f3af0f1353dd5` - Remove legacy icon glyphs and oldName prop support from metadata core.
f3af0f1353dd5 -
Remove legacy icon glyphs and oldName prop support from metadata core.`cba951d9c882d` - Dropping LEGACY_fallback prop from icon-tile
cba951d9c882d -
Dropping LEGACY_fallback prop from icon-tile`ea7a01d023b36` - This release adds and updates icons in @atlaskit/icon.
ea7a01d023b36 -
This release adds and updates icons in @atlaskit/icon.
@atlaskit/icon/core
ai-sparkle@atlaskit/icon/core
chart-pie### Patch Changes - Updated dependencies
`5217ed510493f` - Remove af:export
5217ed510493f -
Remove af:export`3079b06c049d4` - [ux] Removed LEGACY icon props and @atlaskit/icon/core/migration entry point. Users should use icons directly from @atlaskit/icon/co
3079b06c049d4 -
[ux] Removed LEGACY icon props and @atlaskit/icon/core/migration entry point. Users should use
icons directly from @atlaskit/icon/core.### Patch Changes - Updated dependencies
`7925336391df8` - Remove deprecated no-utility-icons ESLint rule as utility icons have been fully removed from @atlaskit/icon package.
7925336391df8 -
Remove deprecated no-utility-icons ESLint rule as utility icons have been fully removed from
@atlaskit/icon package.Your coding agent can read these notes before it upgrades. Set up the MCP server →