PackageTrack
Sign in Get early access

@atlaskit/icon

An icon is a symbol representing a command, device, directory, or common action.

37.5.2 source

What this package is like to depend on

Last release today

26 Aug 2026

Ships on a steady schedule

a new release about every 1 weeks

Nearly every release is documented

notes for 397 of 417 stable releases

1 version withdrawn

withdrawn after publishing

10 years old

418 releases · first in 2017

71 releases in the last 12 months

see the full history below

Release timeline

418 releases · Jan 2017 to Aug 2026
2018 2019 2020 2021 2022 2023 2024 2025 2026
Release Pre-release Withdrawn

Releases

latest 60 of 418
  1. 22.0.2 22 Feb 2024
    Release notes

    Patch Changes

    • #64934 532734a858a1 - Update to internal metadata order, following update of @atlaskit/icon-build-process
    Open source →
  2. 22.0.1 15 Feb 2024
    Release notes

    Patch Changes

    • #72130 b037e5451037 - Update new button text color fallback for default theme (non-token) to match that of old button current text color
    Open source →
  3. 22.0.0 17 Nov 2023
    Release notes

    Major Changes

    • #41812 48b3b440f51 - Removed all remaining legacy theming logic from the Icon and ProgressIndicator components.
    Open source →
  4. 21.12.8 25 Oct 2023
    Release notes

    Patch Changes

    Open source →
  5. 21.12.7 08 Aug 2023
    Release notes

    Patch Changes

    Open source →
  6. 21.12.6 13 Jul 2023
    Release notes

    Patch Changes

    • #36754 4ae083a7e66 - Use @af/accessibility-testing for default jest-axe config and jest-axe import in accessibility testing.
    Open source →
  7. 21.12.5 04 Jul 2023
    Release notes

    Patch Changes

    • #35441 599bfe90ee3 - Internal change to use shape tokens. There is no expected visual change.
    Open source →
  8. 21.12.4 30 May 2023
    Release notes

    Patch Changes

    • #33652 e7ea6832ad2 - Bans the use of React.FC/React.FunctionComponent type in ADS components as part of the React 18 migration work. The change is internal only and should not introduce any changes for the component consumers.
    Open source →
  9. 21.12.3 29 May 2023
    Release notes

    Patch Changes

    • #32935 b1bdec7cce2 - Internal change to enforce token usage for spacing properties. There is no expected visual or behaviour change.
    Open source →
  10. 21.12.2 17 May 2023
    Release notes

    Patch Changes

    Open source →
  11. 21.12.1 15 May 2023
    Release notes

    Patch Changes

    Open source →
  12. 21.12.0 08 May 2023
    Release notes

    Minor Changes

    Patch Changes

    • Updated dependencies
    Open source →
  13. 21.11.5 07 Feb 2023
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  14. 21.11.4 29 Dec 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  15. 21.11.3 28 Dec 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  16. 21.11.2 30 Nov 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  17. 21.11.1 07 Nov 2022
    Release notes

    Patch Changes

    • #25860 88a34a8c2dd - Remove redundant role=presentation on wrapping @atlaskit/icon and @atlaskit/logo spans.
    • 15d704e3090 - For an SVG icon, do not render a aria-label when empty.
    Open source →
  18. 21.11.0 11 Oct 2022
    Release notes

    Minor Changes

    • #24710 a3973745679 - Updates @emotion/core to @emotion/react; v10 to v11. There is no expected behavior change.
    Open source →
  19. 21.10.8 04 Oct 2022
    Release notes

    Patch Changes

    Open source →
  20. 21.10.7 17 May 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  21. 21.10.6 07 Apr 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  22. 21.10.5 17 Mar 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  23. 21.10.4 03 Mar 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  24. 21.10.3 14 Feb 2022
    Release notes

    Patch Changes

    Open source →
  25. 21.10.2 28 Jan 2022
    Release notes

    Patch Changes

    • 19d72473dfb - Updates usage of deprecated token names so they're aligned with the latest naming conventions. No UI or visual changes
    • Updated dependencies
    Open source →
  26. 21.10.1 25 Jan 2022
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  27. 21.10.0 06 Jan 2022
    Release notes

    Minor Changes

    • #17576 1c835620aa5 - Note: It is a re-release of the wrongly patched version 21.9.2 that should have been a minor release.

      CETI-16 added remove emoji icon so that it appears in mobilekit too

    Patch Changes

    • Updated dependencies
    Open source →
  28. 21.9.3 21 Dec 2021
    Release notes

    Patch Changes

    Open source →
  29. 21.9.2 17 Nov 2021 withdrawn

    WRONG RELEASE TYPE - DON'T USE

    Release notes

    Minor Changes

    WRONG RELEASE TYPE - DON'T USE

    • #15998 229177bb85d - CETI-16 added remove emoji icon so that it appears in mobilekit too

    Patch Changes

    • f460cc7c411 - Builds for this package now pass through a tokens babel plugin, removing runtime invocations of the tokens() function and improving bundle size.
    • Updated dependencies
    Open source →
  30. 21.9.1 29 Oct 2021
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  31. 21.9.0 16 Sep 2021
    Release notes

    Minor Changes

    Patch Changes

    • Updated dependencies
    Open source →
  32. 21.8.1 31 Aug 2021
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  33. 21.8.0 26 Aug 2021
    Release notes

    Minor Changes

    • #13864 22b8dd3f590 - Instrumented Icon 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.

    • 88ff832bd2b - Add @atlaskit/icon/glyph/editor/file-preview to atlaskit/icon package for media group toolbar

    Patch Changes

    • Updated dependencies
    Open source →
  34. 21.7.4 19 Aug 2021
    Release notes

    Patch Changes

    Open source →
  35. 21.7.3 28 Jul 2021
    Release notes

    Patch Changes

    Open source →
  36. 21.7.2 23 Jul 2021
    Release notes

    Patch Changes

    • #13102 0c0c4315085 - [ux] Fixed a regression where Icons used static colors in High Contrast Mode when they should actually dynamically respond to changes to the primaryColor and secondaryColor props.
    Open source →
  37. 21.7.1 16 Jul 2021
    Release notes

    Patch Changes

    Open source →
  38. 21.7.0 08 Jul 2021
    Release notes

    Minor Changes

    • #12328 662739d8c28 - Icon now uses internal techstack "design-system: v1" and "styling: emotion".

    Patch Changes

    • 2368dfabe46 - fix Icon appearance in windows high contrast mode
    • 54b0730475e - Fixed an a11y bug associated with the role of the SVGIcon component. The role now correctly adapts to whether a user provides a label or not.
    Open source →
  39. 21.6.1 25 Jun 2021
    Release notes

    Patch Changes

    • #11649 9f5d6ed95f0 - Added aria-hidden to icon wrapper when there is no label provided
    Open source →
  40. 21.6.0 27 May 2021
    Release notes

    Minor Changes

    • #11113 b9c78813d40 - Use named export of base icon instead of default in icon glyphs
    Open source →
  41. 21.5.1 26 May 2021
    Release notes

    Patch Changes

    Open source →
  42. 21.5.0 30 Mar 2021
    Release notes

    Minor Changes

    • #9083 017587eca78 - Icon now exposes an additional component SVG which can be used to for custom icon use cases.
    • 4203387aa43 - Internal changes to the way Icon styles are generated. Additional types have also been exposed to match the glyph component.

    Patch Changes

    • 469f36d9629 - Icon build tooling has been updated.
    • d6580503ce9 - Internal refactor for JSDoc annotated modules.
    • 3de10e7652e - Documentation updates and fixes to types for all icon packages.
    • d98f1bb1169 - Local build tooling improvements.
    Open source →
  43. 21.4.0 09 Mar 2021
    Release notes

    Minor Changes

    • #8644 2f1a299688b - The sizeOpts type has been renamed to Size, available in both the ./ and ./types entrypoints.

    Patch Changes

    • 79c23df6340 - Use injected package name and version for analytics instead of version.json.
    • f922302ad53 - Icons no longer ship with the focusable attribute in their glyph exports. This attribute was only required for IE11 support. This is purely a build change and has no effect on user API.
    Open source →
  44. 21.3.0 24 Feb 2021
    Release notes

    Minor Changes

    • #8178 b9265389fa0 - Icon now exposes a base icon via the @atlaskit/icon/base entrypoint. This is used in all generated glyphs inside the icon package.

    • 83944ca2cf2 - Icon now ships with cjs, esm, and es2019 bundles for components and utils exported in the icon package. Glyphs unfortunately aren't included and still only export cjs bundles.

    • 6ef8824baee - - Icon now uses React.memo() to stop unnecessary re-renders.

      • A bug in the types for icon sizes has been resolved

      This change also includes a number of quality of life fixes as part of lite mode.

      Internal changes

      • class components have been changed to functional components
      • styled-components has been removed as a peer dependency
      • @emotion/core has been added a direct dependency, base components now use emotion for styling
      • An internal gradient function insertDynamicGradientId has been removed from the runtime
      • Enzyme removed in favour of RTL

      Updating tests

      Tests that rely on enzyme may have issues with this update. We've mostly seen issues with one of the following cases.

      Can't find internal react test id

      Because icon is now wrapped in memo you won't be able to easily find it. This code will fail:

      import BookIcon from '@atlaskit/icon/glyph/book';
      
      <BookIcon />;
      
      wrapper.find('BookIcon');
      

      As a fix you can add memo to the target:

      wrapper.find('Memo(BookIcon)');
      

      Even better, use the test id.

      <BookIcon testId="book-icon" />;
      
      wrapper.find('[data-testid="book-icon"]');
      

      Treating the icon as a button

      Icon hasn't had an onClick handler since many major versions. This code will fail:

      const Example = () => <Button testId="test-id" iconBefore={<SomeGlyph />} />;
      
      // in some teat
      wrapper.find(SomeGlyph).click();
      // OR
      wrapper.find('SomeGlyph').click();
      

      As a fix you can target the button instead:

      wrapper.find('[data-testid="test-id"]').click();
      

    Patch Changes

    • 0741b1556f6 - All icon glpyhs are now built without inline extends helpers, reducing their bundlesize.
    • 8d6c79b9055 - Typedefs of glyphs have been updated to reflect an API change that occured in version 15. For context, onClick was removed as a functional prop but it was still supported by the types. This may have resulted in a confusing developer experience although the fundamental behaviour has been consistent since version 15.
    Open source →
  45. 21.2.4 09 Feb 2021
    Release notes

    Patch Changes

    Open source →
  46. 21.2.3 27 Jan 2021
    Release notes

    Patch Changes

    • #7425 b9f0d16300 - Re-generated icons using a newer version of the build process
    Open source →
  47. 21.2.2 20 Jan 2021
    Release notes

    Patch Changes

    • #7589 c65f28c058 - Change codemod to return raw source if it is not transforming a file.

      Otherwise it would run prettier which can lead to some invalid syntax outputted in edge cases. This is likely due to an issue in either codemod-cli or jscodeshift.

    Open source →
  48. 21.2.1 15 Jan 2021
    Release notes

    Patch Changes

    • #7458 bc896a20b0 - Add a missing codemod for the entrypoint change in 21.2.0


      Running the codemod cli

      To run the codemod: You first need to have the latest version installed before you can run the codemod

      yarn upgrade @atlaskit/PACKAGE@^VERSION

      Once upgraded, use the Atlaskit codemod-cli;

      npx @atlaskit/codemod-cli --parser [PARSER] --extensions [FILE_EXTENSIONS] [TARGET_PATH]

      Or run npx @atlaskit/codemod-cli -h for more details on usage. For Atlassians, refer to this doc for more details on the codemod CLI.

    Open source →
  49. 21.2.0 04 Jan 2021
    Release notes

    Minor Changes

    • #7170 fbdf356800 - Remove undocumented metadata export from main entry point. To import metadata instead do it from the /metadata entrypoint.
    Open source →
  50. 21.1.4 15 Oct 2020
    Release notes

    Patch Changes

    • #5497 5f58283e1f - Export types using Typescript's new "export type" syntax to satisfy Typescript's --isolatedModules compiler option. This requires version 3.8 of Typescript, read more about how we handle Typescript versions here: https://atlaskit.atlassian.com/get-started Also add typescript to devDependencies to denote version that the package was built with.
    Open source →
  51. 21.1.3 02 Oct 2020
    Release notes

    Patch Changes

    • Updated dependencies
    Open source →
  52. 21.1.2 02 Sep 2020
    Release notes

    Patch Changes

    • #4649 d6ff4c7dce - Removes unused (and incorrect) es2019 key in package.json
    Open source →
  53. 21.1.1 01 Sep 2020
    Release notes

    Patch Changes

    • #4682 f51e6ff443 - License updated to Apache 2.0 (previously under the ADG license)
    Open source →
  54. 21.1.0 01 Sep 2020
    Release notes

    Minor Changes

    • #4424 2f414dd083 - The new ArchiveIcon is now available to use via import ArchiveIcon from '@atlaskit/icon/glyph/archive';
    Open source →
  55. 21.0.3 24 Aug 2020
    Release notes

    Patch Changes

    • #3885 6c525a8229 - Upgraded to TypeScript 3.9.6 and tslib to 2.0.0

      Since tslib is a dependency for all our packages we recommend that products also follow this tslib upgrade to prevent duplicates of tslib being bundled.

    Open source →
  56. 21.0.2 17 Aug 2020
    Release notes

    Patch Changes

    • #3823 6262f382de - Use the 'lodash' package instead of single-function 'lodash.*' packages
    Open source →
  57. 21.0.1 15 Jul 2020
    Release notes

    Patch Changes

    Open source →
  58. 21.0.0 02 Jul 2020
    Release notes

    Major Changes

    • #3335 87f4720f27 - Officially dropping IE11 support, from this version onwards there are no warranties of the package working in IE11. For more information see: https://community.developer.atlassian.com/t/atlaskit-to-drop-support-for-internet-explorer-11-from-1st-july-2020/39534

    Patch Changes

    • Updated dependencies
    Open source →
  59. 20.1.2 07 May 2020
    Release notes

    Patch Changes

    Open source →
  60. 20.1.1 24 Apr 2020
    Release notes

    Patch Changes

    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive